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ambiente .NET Core. Com toda essa responsabilidade, a 
linguagem precisa evoluir constantemente para incorporar novos 
recursos e assim poder continuar oferecendo um ambiente 
produtivo e robusto. 


Nesse contexto, estar atualizado e conhecer os novos recursos 
da linguagem C# e do ambiente .NET Core pode fazer a diferença 
tanto no quesito desempenho quanto na produtividade. Embora 
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quem deseja migrar para essa linguagem. 


Assim, este livro traz uma visão panorâmica atual da 
linguagem C#, comparando a evolução do código com exemplos 
práticos e pontuais, e, dessa forma, você não fica obrigado a uma 
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tópico de seu interesse no momento e usando a obra como um 
manual de consulta e referência para o dia a dia. 
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INTRODUÇÃO 


Alta produtividade é um objetivo perseguido por todo bom 
profissional em qualquer área. Quando se fala em desenvolvimento 
de software, especificamente, para alcançá-la não basta ter foco e 
esforço. Isso porque a todo momento surgem novas linguagens de 
programação que a cada release trazem novas funcionalidades, sem 
falar em uma infinidade de frameworks e bibliotecas. Infelizmente, 
mesmo que estudemos da hora de acordar até a hora de dormir 
todos os dias de nossas vidas, não seremos capazes de assimilar e 
principalmente colocar em prática, nos projetos em 
desenvolvimento, todas as opções fornecidas pelos fabricantes das 
tecnologias que utilizamos, pelo simples fato de que elas evoluem e 
são trocadas em uma velocidade insana. 


Por outro lado, se pararmos para analisar com calma as 
principais linguagens de programação utilizadas no mercado de 
TI, veremos que a maior parte possui funcionalidades similares, 
como suporte a Orientação a Objetos, Generics, Inferência de tipos, 
Tipos anônimos, Expressões Regulares, Reflection, Programação 
Assíncrona, dentre outras. 


Em termos práticos, o que faz toda a diferença é o fato de que 
algumas linguagens foram pensadas para serem mais concisas e 
legíveis que outras, características estas que aumentam 
substancialmente a nossa produtividade. Junte a uma delas uma 
IDE poderosa como o Visual Studio e um profissional que conhece 
bem suas ferramentas de trabalho e você terá a fórmula perfeita 
para se destacar no mercado e tocar seus projetos profissionais e 
pessoais na velocidade que almeja. 


Criada há cerca de 22 anos, tendo como base linguagens como 
C++ e Java, a linguagem Cf tem inovado a cada novo release e 
revolucionado a forma como se produz software. Ela é hoje a 
principal linguagem de desenvolvimento da Microsoft para as 
plataformas desktop, web e mobile e, com frequência, inclui 
funcionalidades que rapidamente caem no gosto dos 
desenvolvedores e depois são copiadas pelos concorrentes. 


Ao longo deste livro 100% prático e recheado de exemplos 
curtos e simples, reunimos recursos suportados pelas versões mais 
recentes do compilador C# que, ao serem aplicados no código 
produzido, vão impactar positivamente no tamanho do código 
gerado e no tempo envolvido, resultando em alta produtividade. 


Seguindo o mantra do “menos é mais”, você verá que existem 
novas formas de se resolver velhos problemas e que, só porque algo 
funciona, não significa que seja a melhor forma de concluir a 
tarefa. Produtividade em C# foca no que realmente importa para 
quem quer produzir um código elegante e de qualidade. Tenha em 
mente que o nosso código é o nosso melhor cartão de visitas e que 
é preciso se reinventar sempre. Venha conosco conhecer o que a 
linguagem Cf tem de melhor a nos oferecer. 


Bom estudo e sucesso em seus projetos! 
Cláudio Ralha 


(Novembro de 2020) 


EXECUTANDO OS PROJETOS 
UTILIZANDO O .NET 5 


A unificação dos frameworks .NET e .NET Core está se 
tornando uma realidade com a chegada do .NET 5. É uma 
mudança inevitável para a qual precisamos estar preparados e que 
nos brindará com vários recursos novos introduzidos no Cf 9.0 e 
outros que já estão em desenvolvimento para o C# 10.0. 


No momento em que a escrita deste livro foi finalizada 
(novembro de 2020), o novo framework havia acabado de ser 
lançado e para testar as novidades introduzidas na linguagem Cf 
9.0, ainda é necessário executar alguns passos que envolvem: 


a) A atualização da sua cópia do Visual Studio através do 
instalador do Visual Studio. Note que não é mais necessário 
instalar o Visual Studio Preview, versão da IDE que contém 
recursos ainda não incluídos na versão de produção. A distribuição 
Community gratuita é suficiente para executar todos os exemplos 
deste livro. 


b) A configuração da versão correta do .NET em uso após a 
criação de um projeto. Por enquanto, os projetos aparecem pré- 
configurados para o .NET 3.1 apesar de o .NET 5 já estar presente 
na lista de opções. Esses passos obviamente deixarão de ser 
necessários em futuras atualizações do Visual Studio. 


Para criar uma aplicação de teste, execute os seguintes passos: 


1. Execute o Visual Studio atualizado e crie um novo projeto 
do tipo Aplicação de Console (NET Core) em C#. Atenção neste 


passo para não se confundir e escolher a opção Aplicação de 
Console (NET Framework), que só permitirá escolher até o 
Framework .NET 4.8. 


2. O projeto criado está configurado por padrão para usar o 
NET Core 3.1 e o C# 8. Para configurá-lo para usar o .NET 5, 
clique com o botão direito do mouse sobre o arquivo do projeto no 
Gerenciador de Soluções e selecione Propriedades. A página de 
propriedades do projeto abrirá. Na guia Aplicativo, selecione em 
Estrutura de Destino a opção .NET 5.0 e a seguir tecle Ctrl + s para 
salvar a alteração. 


Pronto! A partir de agora você já pode experimentar os novos 
recursos incluídos no compilador Cf 9.0. 


USANDO UMA FUNCIONALIDADE DO Cf 9.0 
PARA TESTAR 


O Cf 9.0 introduziu vários recursos novos e alguns deles serão 
abordados neste livro, uma vez que aumentam a nossa 
produtividade e reduzem o nosso esforço. Para este teste inicial 
utilizaremos as instruções de nível superior (em inglês, top level 
statements). 


Apesar do nome pomposo, este recurso é extremamente 
simples e agradará tanto a quem está iniciando na linguagem C# 
quanto aqueles que precisam fazer demonstrações rápidas de 
fragmentos de código sendo executados sem a necessidade de 
inserir o esqueleto de código clichê que vemos em linguagens 
como Cf, Java e C++. Se você pensou no C# se comportando como 
Python, Ruby ou Lua, acertou! 


Para ilustrar o seu uso vamos executar o seguinte roteiro: 


1. No Gerenciador de Soluções, altere o nome do arquivo 
Program.cs para um nome qualquer, por exemplo, Codigo.cs . 
Note que este passo somente ilustra que para usar este recurso não 
estamos mais presos à convenção de ter um arquivo Program.cs , 
no qual normalmente é definido o ponto de entrada através do 
método Main. 


2. Observe o código gerado pelo template da aplicação de 
console em C&. Note que há 12 linhas de código, mas só a linha 
que escreve a mensagem Hello World! possui código realmente 
executável. Usando o novo recurso, poderíamos reescrever o 
código anterior desta forma: 


using System; 
Console.wWriteLine("Hello world!"); 

Ou em uma única linha usando: 
System.Console.wWriteLine("Hello wWorld!"); 


3. Para conferir isso na prática, remova o código gerado pelo 
template do Visual Studio e insira em seu lugar o código a seguir: 


using System; 


Console.writeLine("Testando o recurso de instruções de nível supe 
rior do C& 9.0"); 

DateTime hoje = DateTime.Now; 

DateTime ontem = hoje.AddDays(-1); 

DateTime amanha = hoje.AddDays(1); 

Console.WriteLine($"Ontem: (ontem: dd/MM/yyyy3"); 
Console.wWriteLine($"Hoje: (hoje:dd/MM/yyyy3"); 
Console.WriteLine($"Amanhã: (amanha:dd/MM/yyyy>"); 


4. Tecle Ctrl + F5 e observe que o código desse exemplo 


executa sem erro. 


Parabéns! Você acaba de executar o seu primeiro programa em 
NET 5.0. 


Caso receba a mensagem de erro a seguir, é sinal de que você 
esqueceu de ajustar a versão correta do .NET em uso: 


O recurso 'top-level | statements' não está 
disponível em C# 8.0. Use a versão de linguagem 9.0 ou 


superior. 


As instruções de nível superior dispensam o uso do código 
clichê, com o qual estamos acostumados, e nos permitem escrever 
scripts simples e concisos que podem utilizar qualquer classe do 
framework .NET, retornar valores para o programa chamador e até 
executar código assíncrono. Como restrição, só podemos ter um 
único arquivo de código no projeto que as utilize, caso contrário 
um erro será gerado. 


Boa parte dos exemplos deste livro podem ser reescritos 
usando este novo recurso. Não fizemos desta forma para que ele 
possa ser útil para o maior número de leitores e leitoras, mas você 
está livre para experimentar à vontade, pois não vamos criar 
nenhum projeto de teste que se alongue por vários capítulos. 
Todos os exemplos que apresentaremos são curtos e diretos. 
Produtividade em C& é uma obra que foca no que o time de 
desenvolvimento incluiu de útil e produtivo em todas as versões já 
lançadas do compilador e não em uma versão específica da 
linguagem. 
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CaríTULO 1 


STRINGS 


Strings estão presentes em nossas vidas como desenvolvedores 
desde o primeiro Hello World que escrevemos. Não importa 
quantas linguagens diferentes tenhamos usado desde então, jamais 
esqueceremos a sensação de ver aquele código tão simples rodando 
com sucesso pela primeira vez. Esse momento único representa o 
começo de uma longa jornada. 


Sem o uso de strings não seria possível ler entradas do usuário 
ou escrever mensagens em uma aplicação de console, bater papo 
em mensageiros instantâneos como o WhatsApp e o Telegram, 
postar opiniões em microblogs como o Twitter, interagir em redes 
sociais como o Facebook e o LinkedIn ou consultar ferramentas de 
busca como o Google e o Waze. Dada a sua importância, 
acreditamos que iniciar abordando a manipulação de strings de 
maneira inteligente seja a melhor porta de entrada para um livro 
focado em produtividade. 


Uma string ou cadeia de caracteres é uma coleção sequencial de 
caracteres usada para representar texto. Nas plataformas .NET e 
NET Core, o texto de uma string é representado como uma 
sequência de unidades de código UTF-16 e é possível armazenar 
em memória até 2GB (cerca de 1 bilhão de caracteres). 


(STRINGS 1 


Ao longo deste capítulo, vamos apresentar formas mais 
produtivas de resolver várias tarefas diárias envolvendo a 
manipulação de strings. As dicas que reunimos nas próximas 
páginas tornarão o seu código mais conciso, elegante e legível. 


1.1 CRIANDO STRINGS MAIS LEGÍVEIS 


A concatenação de strings pode ser feita de forma elegante, o 
que garante maior legibilidade ao código-fonte, ou de forma básica 
sem recorrer a recursos mais recentes da linguagem, tornando o 
código mais difícil de entender. Nas próximas seções, veremos 
alguns recursos criados pelo time de desenvolvimento do C& para 
minimizar o efeito conhecido como “código spaghetti". 


Usando interpolação de strings 


No C# 6.0 foi introduzido um recurso chamado interpolação de 
strings. Antes de a linguagem suportá-lo, era necessário certo 
malabarismo para concatenar strings. Veja no exemplo a seguir 
uma das técnicas que era recomendada, baseada no método 
Format da classe String: 
var livro = new Livro(); 


var mensagem = string.Format("(0) é o novo livro de (1)", livro.T 
itulo, livro.Autor); 


Compare o código anterior com a maneira mais simples 
disponível atualmente: 


var livro = new Livro(); 
var mensagem = $"(livro.Titulo) é o novo livro de (livro.Autor)"; 


Note que, para usarmos a interpolação de strings, é necessário 
preceder a string com o caractere $. 


2 1.1 CRIANDO STRINGS MAIS LEGÍVEIS 


Usando o caractere @ para preservar espaços, 
tabulações e quebras de linhas em strings 


Incluir espaços, tabulações e quebras de linha em uma string é 
uma tarefa que costuma dar dor de cabeça. A solução adotada por 
muitos desenvolvedores pode ser vista no exemplo a seguir: 


using System; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


{ 


static void Main(string[] args) 


{ 
var mensagem = "Amigo leitor,\n\n\tobrigado por ter a 
dquirido este livro. Esperamos que ele o ajude em sua jornada diá 
ria de trabalho.\n\nBom estudo!\nCláudio Ralha"; 
Console.writeLine(mensagem); 


} 


Como você pode observar, o exemplo utiliza caracteres de 
controle para inserir quebra de linha ( \n ) e tabulação ( \t ) 
diretamente no texto da string. Ao ser executado, este código vai 
produzir a seguinte saída: 





El CAWINDOWSisystem32hcmd.exe a g x 
Amigo leitor, A 


obrigado por ter adquirido este livro. Esperamos que ele o ajude em sua jornada diária de trabalho. 


Táudio Ralha 


eia estudo! 
ressione qualquer tecla para continuar. . . 











Figura 1.1: Preservando espaços, tabulações e quebras de linhas 


Apesar de ser 100% funcional, este exemplo não é de fácil 
manutenção. Felizmente, existe uma maneira mais simples e 
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legível de obtermos o mesmo resultado. Basta preceder a 
declaração de uma string com o símbolo @ e aplicar as quebras e 
tabulações como mostrado na próxima listagem: 


using System; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


{ 


static void Main(string[] args) 


{ 


var mensagem = @"Amigo leitor, 


obrigado por ter adquirido este livro. Esperamos que ele o aj 
ude em sua jornada diária de trabalho. 


Bom estudo! 
Cláudio Ralha"; 
Console.writeLine(mensagem) ; 


3 


Este recurso, conhecido como verbatim string, é 
particularmente útil quando estamos criando consultas SQL e 
desejamos quebrar a linha para separar as cláusulas. Exemplo: 
var sql = Q"SELECT * 


FROM livros 
WHERE autor = 'Claudio Ralha'"; 


Usando o caractere @ para simplificar a representação 
dos caminhos de arquivos em strings 


O uso do caractere @ , mostrado no tópico anterior, anula os 
caracteres de controle da string. Por esse motivo, evita a 
necessidade de duplicarmos o caractere \ usado para escapar 
caracteres de controle quando precisamos tê-lo representado no 
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texto da string. Quando não o utilizamos, somos obrigados a 
duplicar o caractere \ ao especificar caminhos de pastas e 
arquivos do sistema operacional no Windows. Exemplo: 


var pastaDocumentos = "C:NNUsersiiClaudioRalhaNNDocuments"; 


Obviamente, isso é algo que está longe de ser agradável aos 
olhos de um bom desenvolvedor. Para a nossa sorte, basta 
precedermos a string com o caractere @ para que o compilador 
nos permita especificar o path para o arquivo da maneira como 
estamos acostumados: 


var pastaDocumentos = (QO"C:NUsersiClaudioRalhaNDocuments"; 


Veja no próximo exemplo o mesmo recurso sendo usado para 
simplificar a passagem para um método de uma string de conexão 
para um banco de dados: 


optionsBuilder .UseSqlServer (Q"server=(localdb)Amssqllocaldb;Datab 
ase=Livro;Trusted Connection=True;"); 


Esperamos que, ao atingir esse ponto, você já tenha se 
convencido de que o arroba e o ponto e vírgula são dois caracteres 
que não podem faltar no seu código. 


1.2 CONVERTENDO STRINGS 


A conversão de strings em arrays de bytes ou array de strings é 
outra tarefa que o desenvolvedor executa com frequência, 
principalmente quando precisa consumir métodos das classes dos 
frameworks .NET e .NET Core ou de bibliotecas de terceiros. Para 
lidar com esses cenários, vamos conhecer nas próximas seções 
métodos incluídos no framework para tornar a nossa vida mais 
simples. 
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Convertendo uma string em um array de bytes 


Alguns métodos de classes dos frameworks .NET e .NET Core 
exigem que uma string seja passada como um array de bytes. Para 
fazer essa conversão com o mínimo de esforço, utilize o método 
estático GetBytes , presente na classe Unicode ou na classe 

UTF8 do namespace System.Text.Encoding , para efetuar a 
conversão de string para byte[] . Exemplo: 


string mensagem = "Produtividade em CH"; 
byte[] conteudo = System.Text.Encoding.Unicode.GetBytes (mensagem) 


r 


Para conferir este trecho de código em execução, execute o 
exemplo apresentado no próximo tópico. 


Convertendo um array de bytes em uma string 


Acabamos de ver como efetuar uma string em um array de 
bytes. Haverá casos em que precisaremos fazer o caminho 
contrário, ou seja, transformar um array de bytes em uma string. 
Para executar essa tarefa, utilize o método GetString presente 
nas classes Unicode ou UTF8 do namespace 
System.Text.Encoding . Confira a seguir um exemplo completo 
de como efetuar esta conversão: 


using System; 
using System.Text; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


f 


static void Main(string[] args) 


f 


string mensagem = "Produtividade em CH"; 
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Console.writeLine("String Original:"); 

Console.writeLine(mensagem) ; 

byte[] conteudo = System. Text. Encoding.Unicode.GetByt 
es (mensagem); 


Console.writeLine("Concatenando todos os Bytes em uma 
string de bytes:"); 
StringBuilder builder = new StringBuilder(); 
for (int i = O; i < conteudo.Length, i++) 
{ 
builder .Append(conteudo[i].ToString("x2")); 
3 


Console.wWriteLine(builder.ToString()); 


Console.writeLine("Usando a classe BitConverter para 
colocar todos os bytes em uma string:"); 

string bitString = BitConverter.ToString(conteudo); 

Console.writeLine(bitString); 


Console.writeLine("obtendo a string em Unicode a part 
ir dos Bytes:"); 

string unicodeString = Encoding.Unicode.GetString(con 
teudo, O, conteudo. Length); 

Console.writeLine(unicodeString); 


Observe que esse exemplo ainda apresenta uma forma de listar 

os bytes de um array em uma string usando a classe 

BitConverter . Na próxima imagem, temos a saída produzida 
pelo código dessa listagem: 





| E CAWINDOWS\system32\cmd.exe e [z] x 


String Original: a 
Produtividade em C# 
Concatenando todos os Bytes em uma string de bytes 
50007 2006900640075 5007 40063607 E00600G400B 100680065 0020006500600200043002 300 
Usando a classe BitConverter para colocar todos os bytes em uma stri 
50:00-72-00-65-00-64-00-75 -00-74-00-69-00-76-00-69-00-64-00-61-00-64-00-65-00-20-00-65-00-6D-00-20-00-43-00-23-00 
btendo a string em Unicode a partir dos Bytes: 
Produtividade em CH 
Pressione qualquer tecla para continuar. . . 


| v 





Figura 1.2: Convertendo um array de bytes em uma string 
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Particionando uma string em um array de strings 


O método Split da classe String do C# é usado para 
particionar uma string em um array de strings baseado na lista de 
delimitadores informada. É possível informar como split delimiters 
tanto um único caractere quanto um array de caracteres ou array 
de strings. 


Neste tópico, veremos exemplos de códigos que exploram a 
utilização deste método com diferentes delimitadores para 
particionar strings com o mínimo de esforço. 


A forma mais simples de uso do método Split pode ser vista 
neste primeiro exemplo: 


using System; 


namespace ProdutividadeEmCSharp 


{ 


class Program 
{ 
static void Main(string[] args) 
{ 
Console.writeLine("Livros recentes:"); 
Console.writeLine(); 
//Livros separados apenas por vírgulas 
string livrosRecentes = "Produtividade em C#, Guia de 
Validação de Dados em C&, Guia de Validação de Dados em Visual B 
asic, Guia de Validação de Dados em Python"; 
string[] lista = livrosRecentes.Split(", "); 
foreach (string livro in lista) 
Console.writeLine(livro); 


Aqui, os nomes dos livros estão separados por uma vírgula 
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seguida de um espaço. Confira a saída obtida ao executar o código: 





ES CAWINDOWS\system32\cmd.exe — o x 
Livros recentes: ^ 


produtividade em C# 

uia de Validação de Dados em C# 

aita de Validação de Dados em Visual Basic 
uia de Validação de Dados em Python 

Pressione qualquer tecla para continuar. . . m 








Figura 1.3: Particionando uma string em um array de strings 


Em boa parte dos casos, esta forma básica de particionar uma 
string já será suficiente, variando apenas o caractere usado como 
delimitador. O próximo exemplo ilustra como tratar um cenário 
mais complexo: 


using System; 


namespace ProdutividadeEmCSharp 
{ 
class Program 
{ 
static void Main(string[] args) 
{ 
string pensamento = @"Nosso cérebro é o melhor brinqu 
edo já criado: 
Nele se encontram todos os segredos, inclusive o da felicidade. 
A vida é maravilhosa se você não tem medo dela."; 
Console.wWriteLine("Pensamento de Charles Chaplin:"); 
Console.writeLine(); 
Console.writeLine(pensamento); 
Console.writeLine(); 
Console.writeLine("Palavras:"); 
Console.writeLine(); 
string[] lista = pensamento.Split(new Char[] {' ', ' 


E Fats ERA Tet ne, ig? y); 
foreach (string palavra in lista) 
{ 
if (palavra.Trim() != "") 


Console.writeLine(palavra); 
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Conforme você pode observar ao examinar o código, 
fornecemos um array de delimitadores que nos permitiram 
quebrar com pouco código uma string complexa em uma lista de 
palavras. 


Testando se uma string é nula ou vazia 


Escrever um código para testar se uma variável do tipo string 
contém nulo ou vazio é uma das tarefas que fazemos com maior 
frequência no dia a dia. Ao codificar esse tipo de teste, muitos 
desenvolvedores criarão códigos como o mostrado a seguir: 


string nome = string.Empty; 


if (nome == null || nome == string.Empty) 
{ 
Console.writeLine("variável nome está vazia ou contém null"); 
3 
else 
{ 
Console.writeLine("nome: {nome}"); 
3 


Esse trecho de código realmente efetua os dois testes 
mencionados, mas podemos realizar a mesma validação com 
menos código utilizando o método IsNullorEmpty da classe 
String , conforme ilustrado no próximo fragmento de código: 
string nome = string.Empty; 


if (string.IsNullOrEmpty(nome)) 
{ 


Console.writeLine("variável nome está vazia ou contém null"); 


} 


else 
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Console.wWriteLine("nome: (nome)"); 


1.3 FORMATANDO STRINGS 


A linguagem Cf oferece outras formas de formatar strings 
bastante úteis para o desenvolvedor, além da interpolação de strings 
vista previamente. Quando o nosso objetivo é formatar um valor 
específico, podemos usar tanto o método estático Format da 
classe String , quanto o método ToString , presente na classe 
base object e herdado por todas as demais. 


Usando String.Format para formatar strings 


O exemplo a seguir demonstra como separar data e hora 
utilizando o método Format da classe String : 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
// Formatação de data e hora 
DateTime agora = DateTime.Now; 
string dtStr = String.Format("{0:d} às {0:t}", agora) 
r 
Console.writeLine(dtStr); 
3 
3 
3 
Confira o resultado produzido por esse exemplo na próxima 
janela: 
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ER CNWINDOWSisystem32icmd.exe = o x 


10/12/2019 às 18:33 A 
Pressione qualquer tecla para continuar. . . m 





Figura 1.4: Formatando strings usando o método Format 


Neste segundo exemplo, mostraremos como formatar o preço 
da gasolina em reais com duas casas decimais, utilizando 
novamente o método String.Format : 


using System; 


namespace ProdutividadeEmCSharp 
{ 
class Program 
{ 
static void Main(string[] args) 
{ 
//Formatação de valor monetário 
decimal combustivel = 4.49m; 
string precoCombustivel = String.Format("Combustível: 
to, 0:C2)", combustivel); 
Console.writeLine(precoCombustivel); 


Ao ser executado, esse código produzirá o seguinte resultado 
em uma máquina rodando Windows em português do Brasil: 





EH CAWINDOWSisystem32Acmd,exe — o ea 


Combustivel: R$ 4,49 ? A 
Pressione qualquer tecla para continuar. . . m 








Figura 1.5: Formatando strings usando o método Format 
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O terceiro e último exemplo desta seção faz uso do método 
ToString e de uma máscara para transformar um valor 
numérico em uma string representando um CEP: 


using System; 


namespace ProdutividadeEmCSharp 





{ 
class Program 
{ 
static void Main(string[] args) 
{ 
//Formatação usando uma máscara 
string mascara = "00000-000"; 
int cep = 22620172; 
Console.writeLine(cep.ToString(mascara)); 
3 
3 
3 
Confira na próxima imagem a saída produzida pelo código 
anterior: 
ER CNWINDOWSisystem32icmd.exe — o xX 
22620-172 ^ 


Pressione qualquer tecla para continuar. . . 








Figura 1.6: Formatando strings usando o método ToString 


Ao trabalhar com formatação de valores na plataforma .NET, 
tenha em mente que este é um recurso bastante poderoso e flexível 
que oferece suporte a múltiplas culturas e que requer algumas 
horas de estudo e testes para ser entendido, mas, uma vez 
dominado, trará benefícios significativos para o seu trabalho como 
desenvolvedor. Trata-se de um daqueles assuntos tão desafiantes e 
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apaixonantes quanto as expressões regulares, pois oferece uma 
infinidade de possibilidades. 


Para saber mais sobre este tema, consulte a seguinte página da 
documentação oficial: 


https://docs.microsoft.com/pt-br/dotnet/standard/base- 


types/formatting-types?view=net5 





Substituindo o método Tostring de um tipo 


Cada classe que definimos em C# inclui o método ToString, 
pois este método é definido na classe System.Object , que 
corresponde à classe base de todas as classes. Por padrão, o método 

ToString retorna uma string contendo o nome da própria classe 
e está disponível em todas as classes que criamos. 


Neste tópico, aprenderemos a substituir o método ToString 
de modo que possamos retornar informações sobre os objetos que 
sejam mais significativas e legíveis para humanos. 


Ainda que o nome da classe retornado por padrão pelo método 

ToString possa ser útil, ele não transmite nenhuma informação 

sobre o conteúdo das propriedades do objeto. Confira rodando o 
exemplo a seguir: 


using System; 
namespace ProdutividadeEmCSharp 


{ 


class WebSite 


{ 
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public string Name ( get; set; 5) 
public string URL { get; set; 3 





3 
class Program 
{ 
static void Main(string[] args) 
{ 
WebSite web = new WebSite(); 
web.Name = "Claudio Ralha"; 
web. URL = "http://www.claudioralha.com/"; 
Console.writeLine(web); 
3 
3 
} 
Ao ser executado, ele vai produzir a seguinte saída: 
E CAWINDOWS\system32\cmd.exe — o > S 
ProdutividadeEmCSharp.WwebSite ^ 


Pressione qualquer tecla para continuar. . . 








Figura 1.7: Exibindo o retorno do método ToString de um tipo 


Isso ocorre porque o método WwriteLine internamente chama 
o método ToString do objeto web . Para fornecer detalhes mais 
apropriados aos clientes de suas turmas, será necessário substituir 
o método ToString usando a sintaxe padrão, conforme ilustrado 
no exemplo a seguir: 


class WebSite 


{ 
public string Name { get; set; } 
public string URL { get; set; } 


public override string ToString() 


{ 
return $"{Name} - {URL}"; 
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As informações que você retorna de sua versão substituída do 
ToString podem ser usadas para muitos propósitos nos quais o 
texto legível é desejável. Um dos seus usos mais populares é dentro 
do depurador do Visual Studio. Quando o depurador mostra 
detalhes de variáveis locais ou observadas, a primeira informação 
exibida é gerada chamando o método ToString. 


Em nosso caso, se rodarmos uma vez mais o exemplo, veremos 
que agora são exibidas informações úteis sobre a classe. Confira: 





ES CIWINDOWSisystem32Acmd.exe — o pS 


Claudio Ralha - http://www.claudioralha.com/ A 


Pressione qualquer tecla para continuar. . . m 








Figura 1.8: Substituindo o método ToString de um tipo 


14 SORTEANDO UMA STRING DE UM 
ARRAY OU LISTA 


Sortear valores é uma tarefa que ocorre com frequência no 
desenvolvimento de sistemas. Ao longo desta seção, 
demonstraremos como sortear um item de um array ou lista com o 
mínimo de código usando a classe Random. 


O primeiro exemplo sorteia um funcionário a partir de uma 
lista mantida em um array. Veja: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
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class Program 
{ 
static void Main(string[] args) 
{ 
string[] funcionarios = { "Adriana", "Patrícia", "Mar 
ia Vitória”, 
"Carlos", "vinícius", "Paul 
o", "Leandro", 
"Karina", "Luana", "Juliana 


J; 
Random rand = new Random(); 
int indice = rand.Next(funcionarios.Length); 
Console.wWriteLine($"Funcionário: {funcionarios[indice 
39; 
3 
3 
3 


A classe Random possui três métodos públicos: Next , 
NextBytes e NextDouble . O método Next retorna um 
número aleatório, NextBytes retorna uma matriz de bytes 
preenchidos com números aleatórios e NextDouble retorna um 
número aleatório entre 0.0 e 1.0. 


O exemplo utiliza o método Next para sortear um valor que 
corresponde ao índice do array a ser retornado. O tamanho do 
array é passado como parâmetro para que não seja gerado nenhum 
índice inexistente. 


Na próxima listagem, temos o mesmo código reescrito usando 
uma lista genérica: 


using System; 
using System.Collections.Generic; 


namespace ProdutividadeEmCSharp 


{ 


class Program 
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static void Main(string[] args) 


{ 
List<string> funcionarios = new List<string>() 
{ 
"Adriana", "Patrícia", "Maria Vitória", 
"Carlos", "Vinícius", "Paulo", "Leandro", 
“Karina”, “Luana”, "Juliana" 
J; 
Random rand = new Random(); 
int indice = rand.Next(funcionarios.Count); 
Console.wWriteLine($"Funcionário: {funcionarios[indice 
D 
} 
} 
} 


Conforme você pode observar, esta é uma tarefa simples e 
rápida de implementar. A seguir, apresentamos um exemplo de 
uso do método NextDouble da classe Random . 


1.5 GERANDO UMA STRING RANDÔMICA 


Ao desenvolvermos sistemas, por vezes temos que criar uma 
rotina que gere uma senha temporária para os usuários. O exemplo 
a seguir ilustra como utilizar a classe Random para sortear essa 
senha. Veja: 


using System; 
using System.Text; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
public static string RandomString(int tamanho, bool caixa 
Baixa) 
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StringBuilder sb = new StringBuilder(); 
Random random = new Random(); 
char ch; 
for (int i = 0; i < tamanho, i++) 
{ 
ch = Convert.ToChar (Convert.ToInt32(Math.Floor(26 
* random. NextDouble() + 65))); 
sb.Append(ch); 
} 
if (caixaBaixa) 
return sb.ToString().ToLower(); 
return sb.ToString(); 


3 
static void Main(string[] args) 
{ 
var senha = RandomString(8, true); 
Console.wWriteLine($"Senha: {senha}"); 
3 


A função  Randomstring deste exemplo recebe como 
parâmetros o tamanho da string a ser gerada e um valor booleano 
indicando se ela será em caixa baixa ou não. 


Ao examinar esse código, é provável que você se pergunte se 
não há formas mais simples, elegantes ou concisas de gerar esse 
tipo de string. A seguir, vamos reproduzir algumas soluções 
disponíveis na seguinte thread do site StackOverflow: 


https://stackoverflow.com/questions/1344221/how-can-i- 
generate-random-alphanumeric-strings 


A primeira proposta fornecida por um desenvolvedor que se 
identifica apenas como dtb utiliza LINQ: 


private static Random random = new Random(); 
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public static string RandomString(int length) 


{ 
const string chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ0O123456789"; 
return new string(Enumerable.Repeat(chars, length) 
.Select(s => s[random.Next(s.Length)]).ToArray()); 
} 


No caso de strings randômicas de até 22 caracteres, é possível 
utilizar um valor GUID como base para a string. Confira a seguir 
soluções propostas pelos usuários Douglas e Luis Perez para obter 
uma senha randômica de 8 caracteres: 


Convert .ToBase64String(Guid.NewGuid( ).ToByteArray()).Substring(0, 
8); 


Ou com ainda menos código: 


Convert .ToBase64String(Guid.NewGuid( ).ToByteArray()).Substring(0, 
8); 


1.6 UTILIZANDO COMENTÁRIOS ESPECIAIS 
PARA SINALIZAR O CÓDIGO 


O Visual Studio reconhece um tipo especial de comentário que 
utiliza tokens, como TODO, HACK ou tokens criados pelo próprio 
desenvolvedor. Esse tipo de comentário é usado como atalho para 
sinalizar que um trecho de código não está finalizado, 
possibilitando ao desenvolvedor retornar rapidamente a esse ponto 
do código-fonte e dar seguimento ao trabalho. 


Para sinalizar que algo precisa ser continuado depois, basta 
adicionar uma linha de comentário contendo o token TODO (em 
inglês, “A fazer”). Exemplo: 


//TODO: adicionar um cabeçalho informativo 
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Quando quiser retornar a este local predefinido no código com 
mínimo de esforço, utilize a janela Lista de Tarefas (Task List) do 
Visual Studio. Clique no menu View e selecione a opção Task List. 
Veja que o comentário aparece na lista: 


Entire Solution X Search Task List P- 


Description Project File Line 





TODO: adicionar um cabeçalho informativo ProdutividadeEmCSharp Program.cs 


Figura 1.9: Inspecionando a janela Lista de Tarefas do Visual Studio 


Efetue um duplo clique sobre o item desejado nesta janela e 
observe que o arquivo que contém o comentário é carregado no 
editor de código e o cursor de edição é movido para a linha que 
contém o token. 


1.7 UTILIZANDO EXPRESSÕES REGULARES 
PARA VALIDAR DADOS 


Ao longo dos últimos anos, escrevi vários livros em diversas 
linguagens para uma série chamada Guia de Validação de Dados 
baseada em expressões regulares e algoritmos de checagem de 
dígitos verificadores. Esta seção contém dois exemplos do Guia de 
Validação de Dados em C% incluídos para demonstrar o poder de 
síntese das expressões regulares. 


As expressões regulares são usadas como ferramentas para 
executar com pouco código tarefas complexas, como localizar e 
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extrair múltiplas ocorrências de sequências de caracteres 
específicas dentro de um texto e validar se os dados fornecidos 
pelo usuário obedecem a um formato bem definido. 


Veja a seguir um exemplo simples de como validar um CEP 
entrado pelo usuário baseado na máscara 99.999-999 usando 
expressões regulares em Cf: 


using System; 
using System.Text.RegularExpressions; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


{ 


static void Main(string[] args) 
{ 
string padrao = @"^\d{2}\.\d{3}-\d{3}$"; 
string resposta = string.Empty; 
Regex regex = new Regex(padrao); 
while (true) 


{ 
Console.write("CEP: "); 


resposta = Console.ReadLine().Trim(); 

if (resposta.ToUpper() == "FIM") break; 

string resultado = regex. IsMatch(resposta) ? "vál 
ido" : "inválido"; 

Console.wWriteLine($"(resposta) é um valor (result 
ado) !An"); 


3 


Ao analisar o exemplo, observe que utilizamos a classe Regex 
presente no namespace  System.Text.RegularExpressions 
Esta classe contém métodos para executar todo tipo de operações 
envolvendo expressões regulares. Como o nosso objetivo nesta 
seção é apenas validar entradas do usuário, vamos explorar apenas 


22 1.7 UTILIZANDO EXPRESSÕES REGULARES PARA VALIDAR DADOS 


o método IsMatch, que é usado para verificar se a string passada 
como parâmetro “casa” (combina) com a expressão regular 
armazenada. Note que utilizamos um verbatim (caractere @ ) 
antes da string da expressão regular armazenada na variável 
padrão para evitar a duplicação das barras invertidas. 


As entradas do usuário são capturadas no loop while através 
do método estático ReadLine da classe Console . O método 
Trim é aplicado à variável resposta para remover eventuais 
espaços colocados por engano no início ou no fim do valor 
fornecido. Já o método ToUpper é usado para converter o valor 
entrado em letras maiúsculas para testar se este é igual à palavra 
FIM, o que significa que o programa será encerrado se o usuário 
digitar FIM, Fim, fim ou qualquer outra variação utilizando 
apenas essas três letras nesta ordem. 


Devido ao seu poder de síntese, uma expressão regular (ER) 
nem sempre é algo simples de ser construído, uma vez que ela é 
capaz de condensar em uma única sequência de metacaracteres 
várias regras que compõem um padrão a ser testado. Para lidar 
com esses cenários mais complexos e trabalhosos, a melhor 
abordagem ao elaborar a expressão regular é a de “dividir para 
conquistar”. Na prática, isso significa dividir a ER nas partes que a 
compõe e documentar cada uma delas no momento da sua criação, 
após efetuar uma bateria de testes. 


Na tabela a seguir, temos um exemplo de documentação da 
expressão regular que utilizamos para validar o CEP no exemplo 
anterior: 


Parte Significado 


A O início de uma linha 
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Nd Um algarismo 

{2} Ocorrendo exatamente duas vezes 
N. Um ponto obrigatório 

\d Um algarismo 

{3} Ocorrendo exatamente três vezes 
N- Um hífen obrigatório 

Nd Um algarismo 

{3} Ocorrendo exatamente três vezes 
$ O fim da linha. 


Confira na próxima imagem um exemplo de teste do programa 
de validação de CEPs: 





E CAWINDOWS\system32\cmd.exe — o x 


CEP: 20.360-172 A 
20.360-172 é um valor válido! 





CEP: 18700-234 
18700-234 é um valor inválido! 


CEP: FIM i 
Pressione qualquer tecla para continuar. . . 











Figura 1.10: Validando entradas do usuário usando uma expressão regular 


Observe que a expressão regular que utilizamos é capaz de 
reconhecer apenas o CEP informado segundo a máscara 99.999- 
999 . Este é o formato oficial para código postal e a expressão 
regular que criamos cumpriu o seu papel, mas o que fazer se 
quisermos aceitar também CEPs baseados nas máscaras 99999- 
999 e 99999999 ? Simples, bastaria alterar a expressão regular 
para aceitar os três formatos. Veja: 
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A^(\d{8}) | (\d{5}-\d{3} ) | (\d{2}\. \d{3}-\d{3})$ 


Infelizmente, o receio de ser obrigado a dar manutenção em 
expressões regulares complexas, por si só, é capaz de intimidar 
alguns desenvolvedores a ponto de não tirarem proveito deste 
recurso fantástico. O que muitas vezes eles não sabem ou se 
esquecem é que, primeiro, a maior parte das expressões regulares 
em uso em aplicações comerciais são relativamente simples e, 
segundo, que após uma expressão regular ter sido criada e bem 
testada, dificilmente precisará de manutenção. 


Tenha em mente, contudo, que nem sempre as expressões 
regulares serão suficientes para garantir por si só que o dado que 
está sendo testado é válido. Em alguns casos, por exemplo, como 
CPF e CNPJ existem dígitos verificadores no final do número que 
também precisam ser validados juntamente com a máscara. Para 
estes cenários, precisamos combinar expressões regulares com 
rotinas de checagem de dígitos verificadores. O exemplo a seguir 
demonstra como validar CPFs: 


using System; 
using System.Text.RegularExpressions; 


namespace ProdutividadeEmCSharp 
{ 
class Program 
{ 
public static bool ValidarCPF(string cpf) 
{ 
int n1, n2; 
string[] cpfsInvalidos = new string[] { "00000000000" 
"11111111111", "22222222222", "33333333333", "44444444444", "55 
555555555", "66666666666", "77777777777", "88888888888", "9999999 
9999" }; 
string parteNumerica = cpf.Replace(".", "").Replace(" 
am MEN 
T E 


foreach (string cpfInvalido in cpfsInvalidos) 
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{ 


if (parteNumerica == cpfInvalido) return false; 
3 
for (int x = 0, x <= 1; X++) 
{ 

n1 = 0; 


for (int i = 0; i <= 8 + x; i++) 
{ 
n1 = n1 + Convert.ToInt32(parteNumerica.Subst 
ring(i, 1)) * ((10 + x) - i); 
3 


n2 = 11 - (n1 - (Convert.ToInt32((n1i / 11) * 11)) 
); 
if ((n2 == 10) | (n2 == 11)) n2 = 0; 


if (n2 != Convert.ToInt32(parteNumerica.Substring 
9 + x, 1))) return false; 
3 
return true; 
3 
static void Main(string[] args) 
{ 
string padrao = @"^\d{3}\.\d{3}\. \d{3}-\d{2}$"; 
string resposta = String.Empty; 
Regex regex = new Regex(padrao); 
while (true) 
{ 
Console.write("CPF: "); 
resposta = Console.ReadLine().Trim(); 
if (resposta.ToUpper() == "FIM") break; 
string resultado = (regex.IsMatch(resposta) && Va 
lidarcPF(resposta)) ? "válido" : "inválido"; 
Console.WriteLine($"{resposta} é um valor {result 
ado}!\n"); 
3 
3 


Os valores fornecidos para validar um número de CPF devem 
conter 11 dígitos e incluir obrigatoriamente a presença de ponto e 
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hífen de acordo com a máscara 999.999.999-99 . É importante 
destacar que CPFs que apresentam o mesmo algarismo em todas as 
posições ( 000.000.000-00 , 111.111.111-11 etc.) passam na 
validação dos dígitos verificadores, mas são considerados 
inválidos. 


A expressão regular que utilizamos para validar o CPF verifica 
apenas se a entrada fornecida está em conformidade com a 
máscara 999.999.999-99 : 


ANdLSIN \d{3}\ . \d{3} -\d{2}$ 


Veja a seguir um teste com o CPF fictício válido 
637.658.268 -04 : 





ES CAWINDOWS\system32\cmd.exe = o x 
CPF: 637.658.268-04 ^ 
637.658.268-04 é um valor válido! 


CPF: 123.456.789-10 
123.456.789-10 é um valor inválido! 


CPF: 12345678901 
12345678901 é um valor inválido! 


CPF: FIM ; 
Pressione qualquer tecla para continuar. .. 








v 





Figura 1.11: Validando entradas do usuário usando uma expressão regular e uma função de 
validação de dígitos verificadores 


Caso deseje aceitar CPFs com ou sem máscara, utilize a 
seguinte expressão regular alternativa: 


^(\d{11}) | (\d{3}\ . \d{3}\ . \d{3} -\d{2})$ 
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Para saber mais sobre o uso de expressões regulares em .NET 


e .NET Core, acesse a seguinte página da documentação 


oficial: 


https://docs.microsoft.com/pt-br/dotnet/standard/base- 
types/regular-expressions 





Ao longo deste capítulo inicial, exploramos diferentes formas 
de trabalhar com strings em Cf, demonstrando como é possível 
chegar ao resultado desejado com pouco código quando se 
conhece bem a sua ferramenta de trabalho. 


Assim como os idiomas estão em constante evolução e novas 
palavras vão surgindo ou ganhando novos significados com o 
passar dos anos, uma linguagem como o C# também ganha novas 
funcionalidades ao longo do tempo, com base nas ideias do time de 
desenvolvimento do compilador e em contribuições da 
comunidade técnica. 


Para ter uma ideia do que o futuro nos reserva, visite a 
seguinte página da linguagem C& no GitHub: 


https://github.com/dotnet/csharplang/projects/4 
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CaríTULO 2 


OPERADORES 


O Cf fornece um grande conjunto de operadores predefinidos, 
compatíveis com os tipos internos da linguagem. Operadores são 
símbolos que especificam quais operações serão executadas em 
uma expressão. A precedência e a associação dos operadores na 
expressão determinam a ordem de execução das operações, o que 
pode ser alterado pelo uso de parênteses. 


A linguagem permite que alguns dos operadores existentes 
sejam sobrecarregados, alterando seu significado quando aplicados 
a um tipo definido pelo usuário. 


Neste capítulo, veremos como empregar operadores que 
reduzem consideravelmente o tamanho do código-fonte gerado, 
sem reduzir a sua legibilidade. Nosso tour se iniciará com os 
operadores de incremento e de decremento, passando pelos 
operadores especiais de atribuição. Abordaremos a seguir os 
operadores condicional nulo e de coalescência nula, que podem 
simplificar a lógica e evitar erros. Em seguida, falaremos sobre o 
operador ternário, que nos ajuda a tornar o código mais conciso e 
que costuma confundir alguns desenvolvedores e desenvolvedoras. 
Na seção seguinte, falaremos um pouco sobre o uso dos 
operadores is e is not na criação de código legível (no 
próximo capítulo, forneceremos mais exemplos úteis quando 
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apresentarmos as melhorias incluídas no Cf 9.0 relacionadas com 
a correspondência de padrões). A última parada será demonstrar 
como a sobrecarga de operadores pode tornar o nosso código mais 
simples. 


Ao final, você terá constatado que o emprego de operadores é 
uma das melhores formas para se praticar a velha máxima do 
“menos é mais”, tão em moda atualmente. 


2.1 USANDO OS OPERADORES DE 
INCREMENTO ++ E DE DECREMENTO -- 


O operador de incremento ( ++ ) aumenta seu operando por 
1 . Veja: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
int vitoria; 
vitoria = 1; 
Console.writeLine(++vitoria); 
vitoria = 1; 
Console.writeLine(vitoria++); 
Console.writeLine(vitoria); 
3 
3 
} 


Confira o resultado na próxima imagem: 
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ES CAWINDOWS\system32\cmd.exe — [E] x 
2 
1 
2 


ressione qualquer tecla para continuar. . . m 





Figura 2.1: Usando o operador de incremento ++ 


Vale destacar que o operador pode aparecer antes ou depois de 
seu operando, o que naturalmente confunde alguns 
desenvolvedores, e é usado com frequência em testes de processos 
seletivos. No contexto deste livro, para ser mais produtivo, basta 
lembrar que escrever: 


vitoria++ 
é mais rápido e menos cansativo que: 
vitória = vitória + 1 


O mesmo raciocínio vale para o operador de decremento -- , 
usado para decrementar o operando em 1. 


Os operadores de incremento ++ e decremento -- são 
usados com frequência em loops for . O exemplo a seguir ilustra 
este cenário: 


using System; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


{ 


static void Main(string[] args) 
{ 
for (int i = 0; i < 5; i++) 
{ 


Console.writeLine(i); 
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3 
for (int i=5-1,i>=0, ài--) 
{ 


Console.writeLine(i); 


J 


No próximo exemplo, utilizamos a variável c do tipo char 
como variável de controle do loop for e a incrementamos 
usando o operador de incremento. Veja: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
for (char c = 'a!;, c <= "8"; c++) 
{ 
Console.writeLine(c); 
3 
3 
3 
3 


2.2 USANDO OS OPERADORES ESPECIAIS DE 
ATRIBUIÇÃO 


O C# dispõe de vários operadores de atribuição. Veja a seguir a 
lista extraída da documentação oficial: 


e x= y paraatribuição. 
e x += y para incremento. Adicione o valor de y para o 
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valor de x, armazene o resultado em x e retorne o novo 
valor. 

e x -= y para subtração. Subtraia o valor de y do valor de 
x, armazene o resultado em x e retorne o novo valor. 

e x \*= y para atribuição de multiplicação. Multiplique o 
valor de y com o valor de x, armazene o resultado em x e 
retorne o novo valor. 

e x /= y para atribuição de divisão. Divida o valor de x 
pelo valor de y, armazene o resultado em x e retorne o novo 
valor. 

e x %=y para atribuição restante. Divida o valor de x pelo 
valor de y, armazene o resto em x e retorne o novo valor. 

e x & y para atribuição composta de um operador binário 
AND. Efetue um AND entre o valor de y e o valor de x, 
armazene o resultado em x e retorne o novo valor. 

e x |= y para atribuição composta de um operador binário 
OR. Efetue um OR entre o valor de y e o valor de x, 
armazene o resultado em x e retorne o novo valor. 

e x ^= y para atribuição composta de um operador binário 
XOR. Efetue um XOR entre o valor de y e o valor de x, 
armazene o resultado em x e retorne o novo valor. 

e x <<= y para atribuição de deslocamento para a 
esquerda. Desloque o valor de x para a esquerda em y casas 
decimais, armazene o resultado em x e retorne o novo 
valor. 

e x >>= y para atribuição de deslocamento para a direita. 
Desloque o valor de x para a direita em y casas decimais, 
armazene o resultado em x e retorne o novo valor. 


Obviamente, a maior parte dos desenvolvedores não 
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empregará todos esses operadores no dia a dia. Se você utilizar os 
operadores de atribuição que envolvem as quatro operações 
básicas (soma, subtração, multiplicação e divisão), já sentirá a 
diferença, uma vez que estes são os que ocorrerão com maior 
frequência. Veja a seguir um exemplo simples no qual utilizamos 
esses quatro operadores de atribuição: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
£ 
static void Main(string[] args) 
í 
Console.writeLine("valores iniciais das variáveis:"); 
int x = 10; 
int y = 5; 


Console.wWriteLine($"x: (x) y: {y}"); 
Console.writeLine(); 


Console.writeLine("Empregando operador de atribuição 
de soma:"); 

x += y; 

Console.WriteLine($"x: {x} y: {y}"); 

Console.writeLine(); 


Console.wWriteLine("Empregando operador de atribuição 
de subtração:"); 

x -= y; 

Console.wWriteLine($"x: {x} y: {y}"); 

Console.writeLine(); 


Console.writeLine("Empregando operador de atribuição 
de multiplicação:"); 

x *= y; 

Console.WriteLine($"x: {x} y: {y}"); 

Console.writeLine(); 


Console.wWriteLine("Empregando operador de atribuição 


de divisão:");, 
x /= y; 
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Console.wWriteLine($"x: (x) yo OF); 





} 
} 
} 
Confira a saída produzida por esse exemplo na próxima 
imagem: 
ER CAWINDOWS\system32\cmd.exe Ii] xX 


Walores iniciais das variáveis: 
nt DO ses 


mpregando operador de atribuição de soma: 
Ega Es, 
regando operador de atribuição de subtração: 
weni ye 5 
Empregando operador de atribuição de multiplicação: 
ES MS 
Empregando operador de atribuição de divisão: 
E Es; 


x: 10 
Pressione qualquer tecla para continuar. . 











Figura 2.2: Aplicando os operadores de atribuição 


No exemplo da próxima listagem, utilizamos o operador de 


atribuição de soma em um loop for : 
using System; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
for (int i = 0; i < 10; i += 2) 
{ 
Console.writeLine(i); 
3 
3 
3 
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2.3 USANDO O OPERADOR CONDICIONAL 
NULO ? 


Uma das coisas mais frustrantes para quem desenvolve, ao 
utilizar as primeiras versões da linguagem C#, era a necessidade de 
escrever código para checar explicitamente a condição nula antes 
de poder usar um objeto ou suas propriedades. Veja a seguir um 
exemplo: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
public class Pessoa 
{ 
public string Nome { get; set; } 
public Endereco Endereco { get; set; } 
} 
public class Endereco 
{ 
public string Logradouro { get; set; } 
public string Bairro { get; set; } 
public string Cidade { get; set; } 
public string Estado { get; set; } 
public string Pais { get; set; } 
public string Cep { get; set; } 
} 
class Program 
{ 
static void Main(string[] args) 
{ 
Pessoa pessoa = new Pessoa() { 
Nome = "Cláudio Ralha", 
Endereco = new Endereco() 
{ 
Logradouro = "Rua dos Nerds 123", 
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Bairro = "Alto da Boa Vista", 


Cidade = "Avaré", 

Estado = "São Paulo", 

Pais = "Brasil", 

Cep = "18702-234" 

) 

7; 
if (pessoa != null && pessoa.Endereco != null) 
{ 


Console.WriteLine($"{pessoa.Nome}\n{pessoa.Endere 
co.Logradouro} - {pessoa.Endereco.Bairro}\n{pessoa.Endereco.Cidad 
e} - {pessoa.Endereco.Estado} - {pessoa.Endereco.Pais}\nCep: {pes 
soa.Endereco.Cep)"); 


3 


A parte que nos interessa neste momento é justamente o trecho 
onde checamos se ambos os objetos não são nulos antes de tentar 
armazenar as informações neles contidas. Observe: 


if (pessoa != null && pessoa.Endereco != null) 
{ 

Console.WriteLine($"{pessoa.Nome}\n{pessoa.Endereco.Logrado 
uro} - {pessoa.Endereco.Bairro}\n{pessoa.Endereco.Cidade} - {pess 
oa.Endereco.Estado} - {pessoa.Endereco.Pais}\nCep: (pessoa.Endere 
co.Cep)"); 





3 
Confira a saída produzida por este código na próxima imagem: 
EM CAWINDOWSisystem32Acmd.exe — o x 
láudio Ralha ^ 


ua dos Nerds 123 - Alto da Boa Vista 
varé - São Paulo - Brasil 

ep: 18702-234 

ressione qualquer tecla para continuar. 





Figura 2.3: Testando se os objetos não são nulos antes de acessar seus membros 
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Essa necessidade de checar se um objeto continha nulo antes 
de acessarmos suas propriedades para evitar que uma exceção fosse 
disparada fazia com que o código de nossas aplicações ganhasse 
várias estruturas condicionais. Com a introdução do operador 
condicional nulo (null-conditional operator), tornou-se possível 
usar o ? (ponto de interrogação) da mesma forma como 
utilizamos nos tipos anuláveis (nullabe types), ou seja, basta colocar 
o sinal ? depois da instância e antes de chamar a propriedade. O 
trecho anterior poderia ser substituído pelo seguinte sem risco de 
ocorrer uma exceção: 
Console.WriteLine($"(pessoa?. Nome) infpessoa?.Endereco?. Logradouro 
+ - (pessoa?.Endereco?.BairroJAnfpessoa?.Endereco?.Cidade) - {pes 


soa?. Endereco?. Estado) - (pessoa?.Endereco?.PaisJinCep: (pessoa?. 
Endereco?.Cep)"); 


Obviamente, nesse caso, não estamos considerando o fato de 
que ocorreria a impressão apenas dos espaços em branco no caso 
de a variável pessoa conter um valor nulo. Para testar essa 
condição, comente a declaração da variável pessoa atual e 
acrescente a seguinte linha de código no início do método main : 


Pessoa pessoa = null; 


Ao executar o projeto novamente, você verá que, mesmo no 
cenário em que a variável pessoa não contém uma instância do 
objeto Pessoa , o código usando operador condicional nulo não 
disparou uma exceção. 
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EM CNWINDOWSisystem32Acmd.exe E o x 


Cep: 
Pressione qualquer tecla para continuar. . . m 











Figura 2.4: Usando o operador condicional nulo ? 


Para saber mais sobre o uso do operador condicional nulo, 
consulte: 


https://docs.microsoft.com/pt-br/dotnet/csharp/language- 


reference/operators/null-conditional-operators 





2.4 USANDO O OPERADOR DE 
COALESCÊNCIA NULA ?? 


O C# disponibiliza o operador de coalescência nula ?? , que 
nos permite verificar se há um valor nulo em uma variável, campo 
ou propriedade e atribuir um valor substituto em uma única linha 
de código. Para lidar com cenários como este, muitos 
desenvolvedores fariam algo assim: 


static void Main(string[] args) 


{ 


Pessoa pessoa = null; 
string nome; 
if(pessoa!=null && pessoa.Nome!=null) 


{ 


nome = pessoa.Nome; 


} 


else 
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nome = "Não informado"; 


3 


Console.writeLine(nome); 


Para simplificar esse tipo de código, podemos recorrer ao 
operador ?? do Cf, que é chamado operador de coalescência nula. 
Ele retornará o operando esquerdo se o operando não for nulo; 
caso contrário, ele retornará o operando direito. Veja como ficaria 
o exemplo reescrito: 


static void Main(string[] args) 


Pessoa pessoa = null; 
var nome = pessoa?.Nome ?? "Não informado"; 
Console.writeLine(nome); 


Para obter informações complementares sobre o operador de 
coalescência nula e mais exemplos de aplicação do recurso, 
acesse a seguinte página da documentação oficial: 


https://docs.microsoft.com/pt-br/dotnet/csharp/language- 


reference/operators/null-coalescing-operator 





2.5 USANDO O OPERADOR TERNÁRIO ?: 


O operador condicional ternário ?: retorna um de dois 
valores dependendo do valor de uma expressão booleana, cuja 
sintaxe é mostrada a seguir: 


condição ? primeira expressão : segunda expressão; 
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A condição deve ser avaliada como true ou false . Se for 
verdadeira, primeira expressão será avaliada e se tornará o 
resultado. Caso a condição seja falsa, segunda expressão será 
avaliada e se tornará o resultado. Veja a seguir um exemplo: 


using System; 


namespace ProdutividadeEmCSharp 


{ 


class Program 
{ 
static void Main(string[] args) 
{ 
string classificacao; 
Console.write("Entre a sua idade:"); 
int idade = Convert.ToInt32(Console.ReadLine()); 
classificacao = (idade > 18) ? "Maior de idade" : "Me 
nor de idade"; 
Console.writeLine(classificacao); 


Observe na próxima imagem a saída produzida por esse 
código: 





CAWINDOWSisystem324cmd.exe = m xX 


Entre a sua idade:46 ^ 
aior de idade . 
Pressione qualquer tecla para continuar. . . m 





Figura 2.5: Usando o operador ternário ?: 
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Como você pode notar, o uso do operador ternário torna o 
código muito mais conciso. Para obter mais informações 
sobre o operador ternário, acesse a seguinte página da 
documentação oficial: 


https://docs.microsoft.com/pt-br/dotnet/csharp/language- 


reference/operators/conditional-operator 





2.6 USANDO O OPERADOR LÓGICO IS NOT 


No Cf 9.0 passamos a dispor do operador is not, que nos 
permite tornar mais legíveis testes que antes eram feitos usando o 
operador is . Exemplos: 


if (!(valor is null)) 


{ 

//Código a executar 
3 
if (!(valor is string)) 
{ 

//Código a executar 
} 


Com o suporte ao novo operador, agora podemos reescrever 
esses fragmentos de código conforme mostrado a seguir: 


if (valor is not null) 


{ 

//Código a executar 
3 
if (valor is not string) 
{ 


//Código a executar 
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Para testar o uso do operador is not , execute o seguinte 
programa: 


using System; 


namespace ProdutividadeEmCSharp9 
{ 
class Program 
{ 
static void Main(string[] args) 
{ 
var valores = new object[] { "Produtividade em C&", t 
rue, 9.0, 47, null, DateTime.Now, 'R' }; 


//Antes do C# 9.0 
foreach (object valor in valores) 
{ 
if (!(valor is null)) 
Console.writeLine($"Tipo: (valor.GetType().Fu 
lliName) - Valor: (valor)"); 
else 
{ 
Console.writeLine("valor nulo!"); 
} 
} 


//A partir do C# 9.0 
foreach (object valor in valores) 
{ 
if (valor is not null) 
Console.wWriteLine($"Tipo: (valor.GetType().Fu 
liName) - Valor: (valor)"); 
else 
Console.writeLine("valor nulo!"); 
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2.7 EMPREGANDO A SOBRECARGA DE 
OPERADORES 


Conforme mencionamos previamente, a linguagem C# permite 
que alguns dos operadores existentes sejam sobrecarregados, 
alterando seu significado quando aplicados a um tipo definido pelo 
usuário. 


Para ilustrar como efetuar a sobrecarga de operadores, vamos 
utilizar o exemplo a seguir, no qual definimos o tipo Distancia . 
Observe: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Distancia 
{ 

public int Metros { get; set; } 

public Distancia(int metros) 

{ 
Metros = metros; 

} 

public static Distancia operator +(Distancia a, Distancia 

b) 

í 
Distancia resultado = new Distancia(0); 
resultado.Metros = a.Metros + b.Metros; 
return resultado; 

} 

public static Distancia operator -(Distancia a, Distancia 

b) 

{ 
Distancia resultado = new Distancia(0); 
resultado.Metros = a.Metros - b.Metros; 
return resultado; 

) 
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public static Distancia operator ++(Distancia a) 
{ 

a.Metros++; 

return a; 


public static Distancia operator --(Distancia a) 
{ 

a.Metros--; 

return a; 


public static bool operator ==(Distancia a, Distancia b) 
=> a.Metros == b.Metros; 


public static bool operator !=(Distancia a, Distancia b) 
=> a.Metros != b.Metros; 


public static bool operator <(Distancia a, Distancia b) 
=> a.Metros < b.Metros; 


public static bool operator >(Distancia a, Distancia b) 
=> a.Metros > b.Metros; 


public static bool operator <=(Distancia a, Distancia b) 
=> a.Metros <= b.Metros; 


public static bool operator >=(Distancia a, Distancia b) 
=> a.Metros >= b.Metros; 


class Program 
{ 
static void Main(string[] args) 
{ 
Distancia distancia1 = new Distancia(10); 
Distancia distancia2 = new Distancia(15); 
distancial++; 
distancia2--; 
Distancia distancias = distancial + distanciaZ; 
Console.wWriteLine($"distanciai: (distanciai.Metros)") 


Console.writeLine($"distancia2: (distancia2.Metros)") 
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Console.writeLine($"distancia3: (distancia3.Metros)") 


if (distancial == distancia2) 
Console.writeLine("distanciai é igual a distancia 
21); 
else 
Console.wWriteLine("distanciai é diferente de dist 
anciai2!"); 
if (distanciaí >= distancia2) 
Console.wWriteLine("distanciai é maior ou igual a 
distancia2!");, 
else 
Console.writeLine("distancial é menor que a dista 
nciai2!"9; 


3 


Repare, no código da classe Distancia , em como é simples 
de se implementar a sobrecarga de operadores. Basta criar métodos 
estáticos e preceder o operador que está sendo sobrecarregado pela 
palavra-chave operator . Examine em seguida no método Main 
da classe Program como a sobrecarga de operadores facilita a 
escrita e a leitura do código. 


Confira a saída produzida por esse exemplo na próxima 
imagem: 





EM CAWINDOWS\system32\cmd.exe — E XxX 


distancia2?: 14 ^ 
distancia3: 25 

distancial é diferente de distancial2! 
distancial é menor que a distancial2! 
Pressione qualquer tecla para continuar. . . 








Figura 2.6: Empregando a sobrecarga de operadores 
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É importante destacar que nem todos os operadores podem 


ser sobrecarregados. Para saber quais operadores permitem a 
sobrecarga e quais não suportam, consulte a seguinte página 
da documentação oficial: 


https://docs.microsoft.com/pt-br/dotnet/csharp/language- 
reference/operators/operator-overloading 





Ao atingir este ponto, você já aprendeu os principais segredos 
relacionados a operadores em C& que costumam estar presentes no 
código dos desenvolvedores mais experientes. Não se preocupe em 
decorar todos os nomes exóticos dos operadores que 
mencionamos ou a sintaxe de uso de cada um deles. Procure 
apenas memorizar a quais tipos de cenários cada um dos 
operadores menos populares atendem. A sintaxe pode ser 
facilmente encontrada mantendo este livro por perto, anotando os 
exemplos de usos mais úteis em uma folha ou post-it na sua mesa 
de trabalho ou, em último caso, recorrendo ao Google. 
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CaríTULO 3 


ESTRUTURAS 
CONDICIONAIS E DE 
REPETIÇÃO 


A linguagem C# conta com várias estruturas de repetição e 
estruturas condicionais, em sua maioria derivadas da linguagem 
C++, que nos permitem ir muito além dos resultados obtidos com 
as instruções for e if dos nossos primeiros dias de 
programação. 


Neste capítulo, veremos como e quando empregar laços 
do...while , for , foreach e while , como explorar 
estruturas condicionais switch e como utilizar pattern matching 
(em português, correspondência de padrão) para aumentar a 
legibilidade do código e torná-lo mais conciso. Você perceberá que 
as melhorias relacionadas à correspondência de padrões, 
introduzidas no C& da versão 7.0 à 9.0, tornaram a leitura do 
código tão fácil quanto pseudocódigo e deixaram desenvolvedores 
com background em outras linguagens como Visual Basic e Delphi 
em êxtase. 


Iniciaremos o nosso estudo com uma revisão dos laços 
disponíveis em C& explorando algumas possibilidades 
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desconhecidas para parte dos leitores e leitoras e, então, 
passaremos para os recursos introduzidos nas versões mais 
recentes da linguagem, que tornaram a instrução switch 
incrivelmente flexível e poderosa. Sinta-se à vontade para pular a 
revisão e avançar para a seção Utilizando estruturas condicionais 
switch, caso você esteja interessado somente nas novidades do C#. 


3.1 CRIANDO ESTRUTURAS CONDICIONAIS 
E DE REPETIÇÃO USANDO CODE SNIPPETS 


O editor de código do Visual Studio dispõe de vários atalhos 
(em inglês, code snippets) para a inserção de blocos de código 
referentes a estruturas condicionais e de repetição, também 
conhecidas como estruturas de iteração. Confira os atalhos na 
tabela a seguir: 


Atalho Descrição Locais válidos para inserir o snippet 


Dentro de um método, um 
indexador, um acessador de 


do Cria um loop do while. ; 
propriedade ou um acessador de 
evento. 
Dentro de um método, um 
; indexador, um acessador de 
else Cria um bloco else. se 
propriedade ou um acessador de 
evento. 
Dentro de um método, um 
: indexador, um acessador de 
for Criaumloop for. . 
propriedade ou um acessador de 
evento. 
Dentro de um método, um 
p indexador, um acessador de 
foreach Cria um loop foreach . EN 
propriedade ou um acessador de 
evento. 
Cria um loop for que Dentro de um método, um 
forr decrementa a variável de loop indexador, um acessador de 
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depois de cada iteração. propriedade ou um acessador de 
evento. 


Dentro de um método, um 
indexador, um acessador de 


if Cria um bloco if. . 
propriedade ou um acessador de 
evento. 
Dentro de um método, um 
; À ; indexador, um acessador de 
switch Cria um bloco switch. TEN 
propriedade ou um acessador de 
evento. 
Dentro de um método, um 
; 3 : indexador, um acessador de 
while Cria um loop while. 7 


propriedade ou um acessador de 
evento. 


3.2 UTILIZANDO LAÇOS FOR 


Saber quando utilizar cada uma das estruturas de iteração 
disponibilizadas é vital quando se deseja escrever um código o 
mais simples e legível possível. O C# suporta os seguintes laços: 
do...while , for , foreach e while. 


Para descobrir qual deles empregar em cada caso, precisamos 
responder às seguintes questões: 


1. Que tipo de conjunto será iterado? 

2. O bloco de instruções do laço será executado um número 
predefinido de vezes ou enquanto uma condição for 
verdadeira? 

3. O bloco de instruções do laço deverá ser executado pelo 
menos uma vez ou não? 


Ao longo desta seção e das posteriores vamos apresentar 
quando utilizar cada uma das estruturas de repetições 
mencionadas. Note que, ainda que seja possível reescrever o código 
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de uma estrutura de iteração usando outra equivalente, sempre 
existirá a versão que será mais fácil de ler e que envolverá menos 
código. Por este motivo, reserve um tempo para refatorar partes do 
seu código que podem ser melhoradas. 


Dentre as estruturas de repetição existentes, o for é o laço 
utilizado com maior frequência. Ele é usado quando sabemos de 
antemão quantas vezes o bloco será executado e é composto por 
três partes opcionais separadas pelo sinal de ponto e vírgula: 
inicialização, condições e passos. 


for (inicialização de variáveis; condições; passos) 


{ 


//bloco de instruções a serem executadas até que a condição s 
eja satisfeita 


3 


O exemplo a seguir ilustra as formas mais comuns de um laço 
for . Veja: 


using System; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


f 


static void Main(string[] args) 


{ 


//Exemplo de incremento em 1 
for (int i = 1; i <= 5; i++) 
{ 


Console.writeLine(i); 


//Exemplo de decremento em 1 
for (int i = 5; i >= 1; i--) 
{ 


Console.writeLine(i); 
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//Exemplo de incremento em 2 
for (int i = 1; i <= 5; i += 2) 
{ 


Console.writeLine(i); 


Saiba que, apesar de usarmos variáveis do tipo int como 
variáveis de controle do loop, esta variável pode ser de qualquer 
tipo de dado numérico. Logo, podemos utilizar outros tipos como 
double, decimal, long, char etc. Observe: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
//Exemplo de incremento em 0.01 
for (double i = 1.01D; i < 1.10; i += 0.01D) 
{ 
Console.writeLine(i); 
3 
3 
3 
} 
Confira a saída produzida por esse exemplo na imagem a 
seguir: 
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EH CAWINDOWS\system32\cmd.exe — o x 


La] 

So 

WNE 
> 


FEFFFF 


Pressione qualquer tecla para continuar. . . m 











Figura 3.1: Utilizando uma variável de controle do loop for do tipo double 


Em alguns cenários, precisaremos trabalhar com mais de uma 
estrutura de repetição ao mesmo tempo, criando fragmentos de 
código que são conhecidos como laços aninhados (em inglês, 
nested loops). É possível combinar diferentes estruturas de 
repetição em laços aninhados, sendo mais frequente o uso de laços 
for aninhados. 


O próximo exemplo demonstra como calcular os números 
primos entre 2 e 100 usando dois laços for aninhados. Veja: 


using System; 


namespace ProdutividadeEmCSharp 
{ 
class Program 
{ 
static void Main(string[] args) 
{ 
int i, j; 
Console.writeLine("Números primeiros entre 2 e 100:\n 
); 


for (i = 2; i <= 100; i++) 


{ 
for (j = 2; j <= (i / j); j++) 
{ 
if ((i % j) == 0) break; 
H 
if (j > (i / j)) Console.writeLine(i); 
} 
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Ao analisar esse código, observe que as variáveis de controle 
dos laços i e j foram declaradas antes dos loops para preservar 
o valor de j após o laço for interno. Observe também que 
usamos uma instrução break para abandonar o laço interno 
antes do final. É possível abandonar um loop com break e 

return a qualquer momento e avançar para a próxima iteração 
com continue sem executar código desnecessário. 


Há naturalmente armadilhas que devem ser evitadas quando se 
busca produtividade e legibilidade. O próximo exemplo demonstra 
como trabalhar com duas variáveis de controle de loop em um 
único for : 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
for (int i =0, j=0; i< 5&& j< 10; i++, j++) 
{ 
Console.WriteLine($"i: {i}, J: {j}"); 
3 
3 
3 
} 


O fato de algo assim ser compilável e executável não significa 
que deva estar presente em nossos projetos. Para entender o 
porquê, basta pensar em quanto tempo um desenvolvedor gastaria 
para descobrir os intervalos de interações que este loop com duas 
variáveis de controle executará. Veja a seguir um segundo 
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exemplo, extraído da documentação oficial do Cf, que reforça o 
que devemos evitar: 

int i; 

int j = 10; 

for (i = 0, Console.wWriteLine($"Start: i={i}, j={j}"); i < j; i++ 
,ı j--, Console.WriteLine($"Step: i={i}, j={j}")) 


{ 
// Body of the loop. 


} 


Exemplos como estes dois últimos que apresentamos só fazem 
sentido em provas de processos seletivos ou de certificação para 
avaliar o nível de conhecimento de candidatos em linguagem C#. 
Fuja da complexidade e mantenha o seu código o mais simples 
possível. Como já dizia a velha máxima: "O Diabo está nos 
detalhes"! 


3.3 UTILIZANDO LAÇOS WHILE E DO WHILE 


O laço while éa mais simples das estruturas de repetição. Ele 
executa um bloco de código desde que a condição dada seja 
verdadeira. Utilizamos os laços while e do while quando não 
sabemos previamente quantas iterações o laço terá. 


Veja a seguir um exemplo: 
using System; 
namespace ProdutividadeEmCSharp 


{ 


class Program 


{ 
static void Main(string[] args) 
{ 
int i = 0; 
while (i < 5) 
{ 
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Console.writeLine(i); 


i++; 


Note que, enquanto a condição fornecida for verdadeira, o 
bloco de código do while será executado. Execute o programa e 
observe a saída gerada: 





EM CAWINDOWSisystem32Acmd.exe — m x 


0 
1 
2 
3 
4 
P 


ressione qualquer tecla para continuar. . . m 











Figura 3.2: Utilizando um laço while 


Agora troque o valor de inicialização de i na linha a seguir 
para 5: 
int i = 0; 


e execute novamente o exemplo. Veja que agora o bloco de 
instruções do laço while não foi executado nenhuma vez. Isso 
ocorre porque a condição é avaliada antes do início do bloco de 
instruções. 


Quando necessitamos que o bloco seja executado pelo menos 
uma vez, devemos usar a estrutura de repetição do while . O 
próximo exemplo ilustra o seu uso: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
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class Program 


{ 
static void Main(string[] args) 
{ 
int i = 0; 
do 
{ 
Console.writeLine(i); 
i++; 
3 
while (i < 5); 
3 
3 


Neste caso, mesmo que troquemos o valor de inicialização de 
i para 5,0 bloco de instruções ainda será executado uma única 
vez. 


Como os laços while e do while são muito mais simples 
que os laços for , não nos alongaremos fornecendo explicações 
mais detalhadas sobre o seu uso. 


3.4 UTILIZANDO LAÇOS FOREACH 


A linguagem Cf suporta a estrutura de laço foreach , que nos 
permite percorrer todos os itens de uma coleção com o mínimo de 
esforço. Em um loop foreach , nós avaliamos cada elemento 
individualmente e deste modo um índice não é necessário. Sem 
índices, os loops são mais fáceis de escrever e os programas são 
mais simples. 


O loop foreach retornará cada elemento de uma coleção na 
ordem em que foi definido. Isso é conhecido como enumeração e 
tem como benefício eliminar erros causados pelo tratamento 
incorreto de índices. 
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Observe no exemplo a seguir onde utilizamos for e 
foreach para exibir os itens do array cores : 


using System; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


f 


static void Main(string[] args) 


{ 


string[] cores = { "azul", "vermelho", "amarelo", "ve 
rde", "branca"; “preto” }; 


Console.writeLine("Imprimindo as cores usando um loop 


For: "); 
for (int i = 0; i < cores.Length; i++) 
{ 
string valor = cores[i]; 
Console.writeLine(valor); 
3 


Console.writeLine(); 


Console.writeLine("Imprimindo as cores usando um loop 
Foreach:"); 
foreach (var valor in cores) 


{ 
Console.writeLine(valor); 
3 
3 
3 
3 
Confira na imagem a seguir a saída produzida por esse 
exemplo: 
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ER CNWINDOWSisystem324cmd.exe — o x 


Imprimindo as cores usando um loop For: A 
azul 

vermelho 

amarelo 

verde 

branco 

preto 


Imprimindo as cores usando um loop Foreach: 
azu 

vermelho 

amarelo 

verde 

branco 

preto 

Pressione qualquer tecla para continuar. . . m 











Figura 3.3: Empregando loops foreach 


Ao examinar o código, repare que utilizamos a palavra 
reservada var na declaração da variável de controle do loop 
foreach valor para inferir o seu tipo e simplificar a sintaxe do 
loop. Por este motivo, o code snippet que é inserido pelo Visual 
Studio quando digitamos foreach seguido de tab é montado 
usando a palavra reservada var . Veja: 


5 = class Program 





6 { 

7 = static void Main(string[] args) 

8 

9% E foreach (Var) item in collection) 
10 { 

11 

12 } 

13 } 

14 } 

15 } 


Figura 3.4: Comparando loops for com foreach 


Apesar de foreach ser uma forma elegante e concisa de se 
construir loops, nem sempre será a solução para os nossos 
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problemas. Isso porque o uso de foreach impede que ocorra 
qualquer modificação na coleção durante o loop. Em outras 
palavras, não é possível remover um item da coleção, por exemplo. 


3.5 UTILIZANDO ESTRUTURAS SWITCH 


Até a versão 6 da linguagem Cf, os desenvolvedores 
reclamavam de algumas limitações na estrutura condicional 
switch , que não era tão flexível como as estruturas equivalentes 
em linguagens como Visual Basic e Delphi. Com a chegada da 
versão 7, que passou a suportar pattern matching (abordado em 
detalhes a partir da próxima seção), estas limitações deixaram de 
existir e o código gerado com a estrutura condicional switch se 
tornou extremamente conciso e legível. 


Ao longo desta seção, veremos usos do switch que são 
menos triviais e que não envolvem patterns e continuaremos com 
o tour pela seção seguinte. O primeiro exemplo utiliza um tipo 
enumerado retornado por DayOfweek . Veja: 


using System; 


namespace ProdutividadeEmCSharp 
{ 
class Program 
{ 
static void Main(string[] args) 
{ 
switch (DateTime .Now.DayOfweek) 
{ 
case DayOfWweek.Saturday: 
case DayOfweek. Sunday: 
Console.writeLine("Hoje é final de semana!"); 
break; 
default: 
Console.writeLine("Hoje é dia de trabalho!"); 
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break; 


Observe que, nesse exemplo, temos o mesmo bloco de código 
sendo executado para os dias Sábado (em inglês, Saturday) e 
Domingo (Sunday). Para os dias de trabalho é executado o bloco 

default. 


A saída gerada por este código obviamente vai depender do dia 
da semana em que ele for executado. Confira na imagem a seguir: 





EH CAWINDOWSisystem324cmd.exe — o x 


Hoje é dia de trabalho! : A 
Pressione qualquer tecla para continuar. .. 





Figura 3.5: Empregando switch com uma variável de um tipo enumerado 


Este segundo exemplo ilustra que é possível utilizar switch 
para avaliar uma variável do tipo char eusar return de dentro 
de um bloco do switch, cenário em que omitimos a instrução 

break . Além disso, ele demonstra que em C# a cláusula 
default do switch não é obrigatória. Veja: 


using System; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


{ 


private static string ObterFruta() 


{ 


Random rnd = new Random(); 
int num = rnd.Next(0, 26); //0 a 25 
char letra = (char)('a' + num); 
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switch (letra) 


{ 
case 'a': return "abacate"; 
case 'b': return "banana"; 
case 'c': return "cereja"; 
case 'd': return "damasco"; 
case 'e': return "embaúba"; 
case "F': return “Figo”; 
case 'g': return "goiaba"; 
case 'h': return "heisteria"; 
case 'i': return "ingá"; 
case 'j': return "jamelão"; 
case 'k': return "kiwi"; 
case '1': return "laranja"; 
case 'm': return "mamão"; 
case 'n': return "nespera"; 
case 'o': return "olho-de-boi"; 
case 'p': return "pera"; 
case 'q': return "quina"; 
case 'r': return "romã"; 
case 's': return "sapucaia";, 
case 't': return "tamarindo"; 
case 'u': return "uva"; 
case 'v': return "veludo"; 
case 'w': return "wampi"; 
case 'x': return "xixá"; 
case 'y': return "yamamomo"; 
case 'z': return "zimbro"; 
) 
return "Esta opção não é válida"; 
} 
static void Main(string[] args) 
t 
for (int i = 1; i <= 10; i++) 
{ 
Console.writeLine($"(i): {0bterFruta()}"); 
} 
} 


A saída produzida por este código é randômica. Confira na 
próxima imagem um exemplo: 
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CAWINDOWSisystem32cmd.exe = o x 


: wampi A 
: kiwi 

: uva 

: tamarindo 

: xixá 

: ingá 

: cereja 

: yamamomo 

: veludo 

10: yamamomo 

Pressione qualquer tecla para continuar. . . 


DOIDO EWUNH 











Figura 3.6: Empregando switch com uma variável do tipo char 


Leitores que se divertiram na infância/adolescência com jogos 
como Adedanha e Flor-Fruta (também conhecido como Stop) 
olharão para esse código com saudosismo e adivinharão que o 
autor não conhecia todas essas frutas e teve que recorrer ao Google 
para achar algumas. 


No próximo exemplo, demonstramos como é possível usar o 
switch com tipos anuláveis testando o caso nulo da variável. 
Neste caso, vamos tratá-lo no bloco default . Veja: 


using System; 


namespace ProdutividadeEmCSharp 
{ 


class Program 


{ 


static void Main(string[] args) 
{ 
bool? passou = null; 
switch (passou) 
{ 
case true: 
Console.writeLine("Parabéns!"); 
break; 
case false: 
Console.writeLine("Que pena!"); 
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break; 
default: 
Console.writeLine("Precisamos saber o resulta 
do!" 
break; 


Obviamente, este código reescrito em C# 7.x ficaria mais 
legível: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
bool? passou = null; 
switch (passou) 
{ 
case true: 
Console.writeLine("Parabéns!"); 
break; 
case false: 
Console.writeLine("Que pena!"); 
break; 
case null: 
Console.writeLine("Precisamos saber o resulta 
dgr"; 
break; 
3 
3 
3 
3 


No final da próxima seção, focada em correspondência de 
padrões, apresentaremos mais exemplos de como ganhar 
produtividade com a instrução switch envolvendo as melhorias 
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introduzidas nas versões mais recentes do Cf. 


3.6 EMPREGANDO CORRESPONDÊNCIA DE 
PADRÕES 


O conceito de pattern matching (em português, 
correspondência de padrão) foi introduzido no C# 7.0 com o 
objetivo de checar se um objeto reflete um shape especificado. 


A correspondência de padrões é suportada por meio das 
expressões is e switch. Elas permitem inspecionar um objeto e 
suas propriedades para determinar se ele satisfaz o padrão 
procurado. Através da palavra-chave when , é possível especificar 
regras adicionais para o padrão. 


Antes do C& 7.0, o operador is era usado para verificar o tipo 
de uma variável e, com base no tipo, retornava true ou false. 
A partir do C# 7.0, is fornece três tipos de correspondência de 
padrões: 


e Padrão de constante 
e Padrão de tipo 
e Padrão var 


Vamos ilustrar cada um deles através de exemplos. O padrão 
de constante permite verificar o objeto com qualquer valor. Veja: 


using System; 


namespace ProdutividadeEmCSharp 


{ 


class Pessoa 


{ 
public string Nome { get; set; } 


3.6 EMPREGANDO CORRESPONDÊNCIA DE PADRÕES 65 


public int Idade ( get; set; } 
3 


class Program 


{ 


static void Main(string[] args) 


£ 


Pessoa pessoa = null; 


//checando valor null 
if (pessoa is null) 


{ 
pessoa = new Pessoa 
{ 
Nome = "Cláudio Ralha", 
Idade = 46 
7; 
} 


//checando um valor string 
if (pessoa.Nome is "Cláudio Ralha") 
Console.WriteLine($"0 nome é {pessoa.Nome}"); 


//checando um valor Constante 
if (pessoa.Idade is 46) 
Console.WriteLine("A idade é 46 anos (mas não esp 
alha, 0k?)."); 





) 
) 
} 

Ao ser executado, esse código produzirá a seguinte saída: 
CAWINDOWS\system32\cmd.exe — o xX 
O nome é Cláudio Ralha A 

A idade é 46 anos (mas não espalha, ok?). 
Pressione qualquer tecla para continuar. . . m 








Figura 3.7: Verificando um objeto usando o padrão de constante 


O padrão de tipo permite confirmar o tipo do objeto e atribuir 
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opcionalmente o valor a uma nova variável do tipo dado. O 
próximo exemplo demonstra como utilizá-lo: 


using System; 


namespace ProdutividadeEmCSharp 


{ 

class Pessoa 

{ 
public string Nome { get; set; } 
public int Idade { get; set; } 

3 

class Program 

{ 


static void Main(string[] args) 
{ 
object obj = 22; 
var pessoa = new Pessoa 
{ 
Nome = "Cláudio Ralha", 
Idade = 45 


}; 


if (obj is int) 
Console.wWriteLine($"variável obj possui um valor 
do tipo iñteiro."); 


if (obj is int i) 
Console.wWriteLine($"variável obj possui o seguint 
e valor inteiro: {i}"); 


if (pessoa is Pessoa) 


{ 


Console.writeLine("variável pessoa é do tipo Pess 
Ga.) 


3 


if (pessoa is Pessoa p) 


{ 


Console.wWriteLine($"variável pessoa é do tipo Pes 
soa. Nome: {p.Nome}"); 


} 
} 
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J 

Confira a saída produzida por esse exemplo na imagem a 
seguir: 
E CAWINDOWS\system32\cmd.exe = m x 
Variável obj possui um valor do tipo inteiro. A 


Variável obJ possui o seguinte valor inteiro: 22 
Variável pessoa é do tipo Pessoa. 

Variável pessoa é do tipo Pessoa. Nome: Cláudio Ralha 
Pressione qualquer tecla para continuar. . . m 











Figura 3.8: Verificando objetos usando o padrão de tipo 


O padrão var é um caso especial do padrão de tipo, com a 
diferença de que o padrão corresponderá a qualquer valor, mesmo 
que seja nulo. Veja a seguir um exemplo: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Livro 
{ 
public string Titulo { get; set; } 
public string Autor { get; set; } 
3 


class Program 


{ 


static void Main(string[] args) 


£ 


Livro livro = new Livro(); 
if (livro is Livro 11) 
{ 
Console.wWriteLine($"Tipo da variável 11: {11?.Get 
Type()?.Name)"); 
3 


livro = null; 
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if (livro is Livro 12) 


{ 


Console.writeLine($"Tipo da variável 12: {12?.Get 
Type()?.Name3"); 
3 


if (livro is var 13) 


{ 


Console.WriteLine($"Tipo da variável 13: {13?.Get 
Type()?.Name}"); 
3 


Ao observar a saída gerada por esse código na imagem a seguir, 
note que quando testamos usando is Pessoa 11 o valor será 
true apenas se a variável 11 não contiver null . Por outro 
lado, quando usarmos is var 13 o resultado será sempre true. 





EM CIWINDOWSisystem324cmd.exe = o xX 


Tipo da variável 11: Livro ^ 
Tipo da variável 13: 
Pressione qualquer tecla para continuar. . . 








Figura 3.9: Verificando objetos usando o padrão var 


Note também que foi necessário utilizar o operador condicional 
null junto do método GetType para evitar que fosse lançada uma 
exception do tipo NullReferenceException quando a variável é 
nula (em nosso exemplo, é o caso de 13 ). 


A vantagem que temos ao usar este padrão é que a variável 
declarada com var é do tipo real do objeto. 


Vale ressaltar que, apesar de a expressão padrão is funcionar 
muito bem para validação, haverá casos em que teremos muitas 
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instruções if e else if e poderá ser vantajoso migrar para a 
estrutura condicional switch , que finalmente atingiu o patamar 
tão sonhado por quem gosta de escrever código conciso e com boa 
legibilidade. Ela agora suporta os mesmos três padrões discutidos 
anteriormente. 


O exemplo a seguir demonstra como fazer correspondência de 
padrão de tipo com a instrução switch : 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Animal 
{ 
public string Nome { get; set; } 
} 
class Passaro : Animal 
{ 
public string Alimentacao { get; set; } 
} 
class Cachorro: Animal 
i 
public int Idade { get; set; } 
} 
class Gato : Animal 
{ 
public string Cor { get; set; } 
} 


class Program 


{ 


private static void ReconhecerAnimal(Animal animal) 


{ 


switch (animal) 


{ 


case Passaro p: 
Console.wWriteLine($"(p.Nome) é um pássaro que 
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adora comer (p.Alimentacao)."); 
break; 
case Cachorro c: 
Console.wWriteLine($"(c.Nome) é um cachorro mu 
ito dócil e brincalhão. Ele tem (c.Idade) anos."); 
break; 
case Gato g: 
Console.wWriteLine($"(g.Nome) é um gato (g.Cor 
} que adora miar no telhado dos vizinhos."); 
break; 
default: 
break; 


static void Main(string[] args) 


{ 


var passaro = new Passaro() { Nome = "Namopelão", Ali 
mentacao = "sementes de girassol"}; 

var cachorro = new Cachorro() { Nome = "Neném", Idade 
= 3}; 

var gato = new Gato() { Nome = "Sirius", Cor = "preto 

J; 

ReconhecerAnimal(passaro); 

ReconhecerAnimal(cachorro); 

ReconhecerAnimal(gato); 


Note que, ao definirmos variáveis em cada case , temos 
acesso às propriedades dos objetos. Na imagem a seguir, você pode 
observar a saída produzida pelo exemplo anterior: 





E CAWINDOWS\system32\cmd.exe — oO xX 


Namopelão é um pássaro que adora comer sementes de girassol. A 
Neném é um cachorro muito dócil e brincalhão. Ele tem 3 anos. 

Sirius é um gato preto que adora miar no telhado dos vizinhos. 

Pressione qualquer tecla para continuar. . . m 











Figura 3.10: Empregando a correspondência de padrão de tipo usando switch 
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Um detalhe importante a ser notado é que não é possível 
especificar os blocos case do switch partindo de um tipo pai 
em direção ao tipo filho. O Visual Studio vai avisá-lo em tempo de 
codificação. Veja: 


static void Main(string[] args) 


{ 
dynamic p1 = new Gerente(); 
switch (p1) 
{ 
case Pessoa p: 
Console.WriteLine("Eu sou uma pessoa!"); 
break; 
case Funcionario fi 
Console.WriteL: te (variável local) Funcionario f 
oreak; O caso do switch já foi manipulado por um caso anterior. 
case Gerente g: 
Console.WriteLine("Eu 1 um gerente : 
break: 
} 
} 


Figura 3.11: Sinalização de erro na ordem dos blocos case 


O programa a seguir só será compilável se o pattern matching 
for empregado especificando primeiro os tipos derivados e se a 
variável p1 for declarada como dynamic : 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Pessoa 
t 
public string Nome { get; set; } 
} 
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class Funcionario : Pessoa 





{ 
public string Cargo { get; set; } 
3 
class Gerente : Funcionario 
{ 
public string Filial { get; set; } 
3 
class Program 
{ 
static void Main(string[] args) 
{ 
dynamic p1 = new Gerente(); 
switch (p1) 
{ 
case Gerente g: 
Console.writeLine("Eu sou um gerente!"); 
break; 
case Funcionario f: 
Console.WriteLine("Eu sou um funcionário!"); 
break; 
case Pessoa p: 
Console.writeLine("Eu sou uma pessoa!"); 
break; 
3 
3 
3 
3 
Ao ser executado, ele produzirá a seguinte saída: 
ES CNWINDOWSisystem32icmd.exe — o x 
Eu sou um gerente! A 


Pressione qualquer tecla para continuar. . . 


v 








Figura 3.12: Empregando a correspondência de padrão com tipos derivados de um tipo pai 


O próximo exemplo faz uso da cláusula when para especificar 
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filtros adicionais e mostra como a estrutura condicional se tornou 
poderosa: 


using System; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


f 


private static void ReconhecerCaractere(char c) 


f 


switch (c) 
{ 


case char 1 when (c >= 'a' && c <= 'z') || (c >= 
'A' && c <= 'Z'): 
Console.WwWriteLine($"{c} é um caractere alfabé 


tiço."): 
break; 
case char n when c >= '0' && c <= '9':; 
Console.wWriteLine($"(c) é um caractere numéri 
EO) 
break; 
default: 
break; 
3 
3 
static void Main(string[] args) 
{ 
ReconhecerCaractere('a'); 
ReconhecerCaractere('Z'); 
ReconhecerCaractere('9'); 
3 


Confira a saída produzida por este exemplo na imagem a 
seguir: 
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EM CAWINDOWSisystem32Acmd.exe — o 


a é um caractere alfabético. 

Z é um caractere alfabético. 

9 é um caractere numérico. 

Pressione qualquer tecla para continuar. . . 





Figura 3.13: Usando a cláusula when para especificar filtros adicionais 


Perceba que agora podemos resolver de forma elegante o que 


antes era feito através de múltiplas instruções if . Veja a seguir 


outro exemplo que faz uso da cláusula when em cada case do 


switch : 


using System; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


{ 


private static void ReconhecerFaseDaVida(int idade) 


{ 
string fase = String.Empty; 
switch (idade) 


{ 
case int i when i <= 11: 
fase = "Infância"; 
break; 
case int i when i >= 12 && i<=20: 
fase = "Adolescência"; 
break; 
case int i when i >= 21 && i <= 74: 
fase = "Idade Adulta"; 
break; 
case int i when i >= 75: 
fase = "Velhice"; 
break; 
} 


Console.WwriteLine($"{idade} anos = {fase}"); 


static void Main(string[] args) 
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75 


ReconhecerFaseDaVida(1); 

ReconhecerFaseDaVida(18); 
ReconhecerFaseDaVida(46); 
ReconhecerFaseDaVida(84); 


Ao examinar este código, alguns leitores vão estranhar a 
velhice começando em 75 anos. Esta mudança foi efetuada pela 
Organização Mundial de Saúde, uma vez que muitas pessoas com 
até 65 anos de idade continuam ativas no mercado de trabalho e 
apresentam expectativa de vida maior que anos atrás. 


Confira na próxima imagem a saída produzida por esse código: 





E CNWINDOWSisystem32icmd.exe = o x 


1 anos = Infância ^ 
18 anos = Adolescência 

46 anos = Idade Adulta 

84 anos = Velhice 

Pressione qualquer tecla para continuar. . . 








Figura 3.14: Usando novamente a cláusula when para especificar filtros adicionais 


No exemplo da próxima listagem demonstramos como testar 
no case sea variável contém null. Veja: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Livro 
{ 
public string Titulo { get; set; } 
public string Autor { get; set; } 
3 
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class Program 


{ 


static void Main(string[] args) 
{ 
dynamic livro = new Livro(); 
//livro = null; 
//livro = "Produtividade em C&"; 
switch (livro) 
{ 
case null: 
Console.writeLine("variável livro contém null 
1"); 
break; 
case Livro 1: 
Console.writeLine("variável livro contém obje 
to do tipo Livro!"); 
break; 
default: 
Console.wWriteLine($"variável livro contém obj 
eto do tipo (livro.GetType().Name)!"); 
break; 


Note que há duas linhas comentadas neste código. Ao executar 
a primeira vez o exemplo com as linhas comentadas, você obterá a 
saída mostrada na próxima imagem: 





ES CAWINDOWSisystem32Acmd.exe — o x 


Variável livro contém objeto do tipo Livro! A 
Pressione qualquer tecla para continuar. . . 








Figura 3.15: Testando o valor null em um bloco case de uma instrução switch 


Descomente a primeira linha de comentário, execute 
novamente o código e observe o resultado. Em seguida, 
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descomente também a segunda linha e rode novamente o 
programa para testar os três cenários tratados no switch. 


Aviso de spoiler: para os leitores e leitoras que não ficaram 
contentes com a introdução da clausula when no Cf 8.0 por 
considerarem que existem formas mais inteligentes de 
simplificar as estruturas switch , a boa notícia é que no C& 
9.0 0 switch se tornou ainda mais poderoso e simples de 
codificar com as melhorias nas correspondências de padrões, 


sobre as quais falaremos a seguir. 





Ao começar a desenvolver em Cf 9.0, você descobrirá que ao 
invés de escrever: 
case int i when i >= 12 && i<=20: 


fase = "Adolescência"; 
break; 


Bastará escrever: 


case i >= 12 and i<=20: 
fase = "Adolescência"; 
break; 


3.7 MELHORIAS NA CORRESPONDÊNCIA DE 
PADRÕES DO Cf 9.0 


A linguagem Cf segue evoluindo e, enquanto você está lendo 
esta obra, o time de desenvolvimento está trabalhando nas 
funcionalidades a serem introduzidas nas próximas versões do 
compilador. O C& 9.0 nos trouxe várias melhorias nas 
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correspondências de padrões, conforme você pode observar na 
lista a seguir extraída da documentação oficial de lançamento da 
linguagem: 


e Padrões de tipo testam se uma variável é de um tipo 
específico. 

e Padrões entre parênteses impõem ou enfatizam a 
precedência de combinações de padrões. 

e Padrões de conjuntiva and exigem os dois padrões para 
corresponder. 

e Padrões de disjuntiva or exigem qualquer padrão para 
corresponder. 

e Padrões de negação not exigem que um padrão não 
corresponda. 

e Os padrões relacionais exigem que a entrada seja menor 
que, maior que, menor ou igual ou maior ou igual a uma 
determinada constante. 


Foge ao escopo deste livro apresentar todas as possibilidades 
envolvendo cada uma dessas melhorias, mas saiba que esses 
padrões podem ser usados em qualquer contexto em que os 
padrões são permitidos: is expressões switch de padrão , 
expressões, padrões aninhados e o padrão do rótulo de uma 
instrução case deum switch. 


Nota: no capítulo 2, sobre Operadores, temos um exemplo de 
uso de padrões de negação not (consulte a seção Usando o 


operador is not para tornar o código mais legível). 
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Observe a seguir um exemplo onde aplicamos as melhorias na 
correspondência de padrões que só será compilável usando o C& 
9.0 ou superior: 


using System; 


namespace ProdutividadeEmCSharp9 


{ 


static class Caractere 
{ 
public static bool ELetra(this char c) => 
c is >= 'a' and <= 'z' or >= 'A' and <= 'Z'; 


public static bool ELetraMinuscula(this char c) => 
c is >= 'a' and <= 'z'; 


public static bool ELetraMaiuscula(this char c) => 
c is >= 'A' and <= 'Z'; 


public static bool ELetra0uNumero(this char c) => 
c is (>= 'a' and <= 'z') or (>= 'A' and <= 'Z') or (> 
= '0' and <= '9'); 


public static bool ESinalDePontuacao(this char c) => 
ċċ is "i" ọor "Z" or 4" or 4t or "rt of "4% or 7 


r 


class Program 


{ 
static void Main(string[] args) 
{ 
var frase = "Bem-vindo ao C# 9.0!"; 
if (frase is not null) 
{ 


foreach (char c in frase) 


{ 
Console.WriteLine($"Caractere: {c} Letra ou N 
úmero: {c.ELetra0uNumero()}"); 


} 
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Percebeu como o código agora está fácil de ler? Vamos nos 
concentrar no método ELetra a seguir: 
public static bool ELetra(this char c) => 

c is >= 'a' and <= 'z' or >= 'A' and <= 'Z'; 

O and eo or finalmente chegaram ao C#! Este detalhe, 
junto da presença do is , tornou a leitura das condições muito 
mais simples. E ainda temos a possibilidade de usar parênteses 
opcionais para enfatizar a precedência, conforme ilustrado no 
método: 
public static bool ELetra0uNumero(this char c) => 

c is (>= 'a' and <= 'z') or (>= 'A' and <= 'Z') or (>= '0' an 
d <= '9'); 

O próximo exemplo mostra as melhorias na correspondência 
de padrões aplicadas a instruções switch e também só é 
compilável usando o C# 9.0 ou superior: 


using System; 


namespace ProdutividadeEmCSharp9 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
var valor = 3; 
switch (valor) 
{ 
case < 0: 
Console.WriteLine($"Valor {valor} é menor que 
or"); 
break; 
case 0: 
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Console.wWriteLine($"valor (valor) é igual a O 
1"); 
break; 
case > O and <= 10: 
Console.WriteLine($"Valor {valor} é maior que 
O e menor ou igual a 10!"); 
break; 
default: 
Console.writeLine($"valor (valor) é maior que 
101"); 
break; 


Leitores e leitoras com background em linguagens como Visual 
Basic, Delphi, Python, Ruby e Lua devem estar se perguntando: 
“Mas afinal, por que não fizeram assim desde a versão 1.0?”. 
Concordo, mas lembre-se de que às vezes ficamos presos tempo 
demais às nossas origens! No caso do C&, ao C++ e ao Java. 


3.8 COMPACTANDO INSTRUÇÕES SWITCH 
USANDO EXPRESSÕES SWITCH 


Em muitos casos, utilizamos uma instrução switch para 
retornar um valor em cada um de seus blocos case . Para lidar 
com estes cenários, o C# 8.0 introduz expressões switch que nos 
permitem aplicar uma sintaxe de expressão mais concisa, uma vez 
que elas descartam o uso de palavras-chave case e break. 


Vejamos a seguir um exemplo de uso das expressões switch: 
using System; 
namespace ProdutividadeEmCSharp 


{ 


public enum Estacao 
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Primavera, 
Verao, 
Outono, 
Inverno 


class Program 
{ 
public static string Pedir(Estacao estacao) => 
estacao switch 
{ 
Estacao.Primavera => "Traz uma flor para mim!", 
Estacao.Verao => "Traz um sorvete para mim!", 
Estacao.0utono => "Traz um vinho para mim!", 
Estacao. Inverno => "Traz uma barra de chocolate p 
ara mim!", 
— => throw new ArgumentException(message: "Valor 
do enum inválido!", paramName: nameof (estacao)) 


F; 
static void Main(string[] args) 

{ 
Console.WwriteLine(Pedir(Estacao.Primavera)); 
Console.writeLine(Pedir(Estacao.Verao)); 
Console.wWriteLine(Pedir(Estacao.0Outono)); 
Console.wWriteLine(Pedir (Estacao. Inverno)); 

3 


Perceba que há várias melhorias na sintaxe desta construção: 


e O posicionamento da variável antes da palavra-chave 
switch ajuda a distinguir visualmente a expressão switch 
da instrução switch. 

e Os corpos são expressões, não instruções. 

e Os elementos case e : são substituídos por => (mais 
conciso e intuitivo). 

e Ocaso default é substituído por um descarte _ 
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Na próxima imagem podemos observar a saída gerada pelo 
exemplo anterior: 














EH CAWINDOWSisystem32hcmd.exe — x 


Traz uma flor para mim! A 
Traz um sorvete para mim! 

Mraz um vinho para mim! 

Mraz uma barra de chocolate para mim! 

Pressione qualquer tecla para continuar. . . m 











Figura 3.16: Empregando uma expressão switch 


Fantástico, não é mesmo? Pois saiba que com as melhorias nas 
correspondências de padrão trazidas pelo C# 9.0 e o .NET 5.0 
ainda podemos ir além. A partir desta versão do compilador 
podemos reescrever o último exemplo da seção anterior usando 
expressões switch como a mostrada a seguir: 


using System; 


namespace ProdutividadeEmCSharp9 
{ 
class Program 
{ 
static void Main(string[] args) 
{ 
var valor = 3; 
var mensagem = valor switch { 
< 0 => $"Valor {valor} é menor que 0!", 
0 => $"valor (valor) é igual a 0!", 
> 0 and <= 10 => $"valor (valor) é maior que 0 e 
menor ou igual a 10!", 
— => $"valor (valor) é maior que 10!" 
Fi 


Console.writeLine(mensagem); 


Voilá! Simples, fácil e elegante como sempre sonhamos! 
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Para saber mais sobre expressões switch, consulte a seguinte 
seção da documentação oficial: 


https://docs.microsoft.com/pt-br/dotnet/csharp/whats- 
new/csharp-84switch-expressions 


Para saber mais sobre correspondência de padrões e obter 
outros exemplos, consulte: 


https://docs.microsoft.com/pt-br/dotnet/csharp/whats- 


new/csharp-7épattern-matching 


https://docs.microsoft.com/pt-br/dotnet/csharp/whats- 
new/csharp-9%pattern-matching-enhancements 





Conforme você deve ter percebido ao analisar os exemplos 
apresentados neste capítulo, quanto mais você conhecer os 
recursos fornecidos pela linguagem, mais será capaz de produzir 
códigos elegantes com menos esforço. 


Lembre-se de que o C# não para de evoluir e de nos brindar 
com recursos que reduzem o trabalho braçal. Procure descobrir as 
novidades incluídas em cada versão do compilador liberada pela 
Microsoft e exemplos práticos de empregabilidade de cada nova 
funcionalidade. Aos poucos, você encontrará verdadeiras joias 
escondidas na linguagem e no Visual Studio e se tornará um 
profissional cada dia mais completo. 
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CAPÍTULO 4 


TIPOS E MEMBROS 


Em linguagens orientadas a objetos, como C%, todo o nosso 


código está contido em tipos que são compostos por classes e 


estruturas. Os tipos possuem membros públicos e privados que 


representam seus dados e comportamentos, construtores e 


finalizadores. 


Ao longo deste capítulo, veremos como tirar proveito de várias 


simplificações e melhorias incluídas na linguagem Cf para torná-la 


mais poderosa e flexível. Nas próximas seções, você aprenderá a: 
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empregar tipos anuláveis usando sintaxe simplificada; 

usar literais binárias e separadores de dígitos; 

criar múltiplos construtores de instância para uma classe; 
declarar uma propriedade autoimplementada como 
somente leitura ou somente escrita; 

atribuir um valor inicial a uma propriedade 
autoimplementada na sua declaração; 

simplificar o código de propriedades calculadas com 
expressões lambda; 

utilizar propriedades somente de inicialização em classes, 
structs e registros; 

iterar sobre um tipo enumerado; 

utilizar inicializadores de objetos e inicializadores de 
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coleções; 

e utilizar parâmetros opcionais e parâmetros nomeados; 

e utilizar métodos de extensão para estender uma classe; 

e usar dynamic para retornar objetos diferentes em tempo 
de execução; 

e utilizar yield em vez de criar coleções temporárias; 

e utilizar using para declarar objetos descartáveis; 

e utilizar métodos de interface padrão para fornecer 
implementação para membros de uma interface; 

e utilizar new expressions para inicializar objetos; 

e utilizar registros para criar tipos de referência imutáveis. 


Conforme você pode observar, há muitas funcionalidades 
avançadas suportadas pela linguagem C& que acabam ficando de 
fora do código gerado pela maioria dos desenvolvedores. Conhecer 
e empregar estes recursos vai ajudar você a criar sistemas mais 
legíveis e robustos com menos código e a completar as suas tarefas 
em menos tempo. 


4.1 CRIANDO TIPOS E MEMBROS USANDO 
CODE SNIPPETS 


O editor de código do Visual Studio dispõe de vários atalhos 
(em inglês, code snippets) para a inserção de tipos e membros. 
Confira os atalhos na tabela a seguir: 


Locais válidos para inserir 


Atalho Descrição y 
o snippet 
Dentro de um namespace 
(incluindo o namespace 
class Cria uma declaração de classe. global), uma classe ou um 


struct. 
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ctor 


enum 


exception 


indexer 


interface 


iterator 


iterindex 


namespace 


prop 


propfull 


propg 


sim 


struct 


Cria um construtor para a classe que 
o contém. 


Cria uma declaração enum. 


Cria uma declaração para uma classe 
que deriva de uma exceção 
(Exception, por padrão). 


Cria uma declaração do indexador. 


Cria uma declaração interface. 


Cria um iterador. 


Cria um par de iterador e indexador 
"nomeado" usando uma classe 
aninhada. 


Cria uma declaração de namespace. 
Cria uma declaração de propriedade 


autoimplementada. 


Cria uma declaração de propriedade 
com os acessadores get e set. 


Cria uma propriedade 
implementada automaticamente do 
tipo somente leitura, com um 
acessador set particular. 


Cria uma declaração de método 
principal static int. 


Cria uma declaração estrutura. 


Dentro de uma classe. 


Dentro de um namespace 
(incluindo o namespace 
global), de uma classe ou de 
um struct. 


Dentro de um namespace 
(incluindo o namespace 
global), de uma classe ou de 
um struct. 


Dentro de uma classe ou de 
um struct. 


Dentro de um namespace 
(incluindo o namespace 
global), de uma classe ou de 
um struct. 


Dentro de uma classe ou de 
um struct. 


Dentro de uma classe ou de 
um struct. 


Dentro de um namespace 
(incluindo o namespace 
global). 


Dentro de uma classe ou de 
um struct. 


Dentro de uma classe ou de 


um struct. 


Dentro de uma classe ou de 
um struct. 





Dentro de uma classe ou de 
um struct. 


Dentro de um namespace 
(incluindo o namespace 
global), uma classe ou um 
struct. 
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Cria uma declaração de método Dentro de uma classe ou de 


2m principal static void. um struct. 


4.2 UTILIZANDO A SINTAXE SIMPLIFICADA 
EM TIPOS ANULÁVEIS 


Os tipos anuláveis (em inglês, nullable types) foram 
introduzidos no C& 2.0 para permitir o suporte a valores nulos em 
tipos de valor. São instâncias da estrutura System.Nullable<T>, 
particularmente úteis quando estamos lidando com dados 
mantidos em banco de dados e precisamos ler valores numéricos e 
booleanos que podem estar ou não presentes nos registros. A 
declaração formal de um tipo anulável pode ser vista a seguir: 


Nullable<T> variável = null; 


Apesar de útil, recomendamos para fins de produtividade que 
seja usada a forma curta alternativa suportada pela linguagem, 
mais legível e simples: 


T? variável = null; 


O exemplo a seguir ilustra como declarar um tipo anulável 
inteiro usando a forma curta e como testar se ele contém valor ou 


nao: 
using System; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


{ 


static void Main(string[] args) 


{ 


int? classificacao = null; 
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int posicao = 0; 

//classificacao = 2; 

if (classificacao.HasValue) { 
posicao = classificação.Value; 


3 


Console.wWriteLine($"Classificação: (classificacao)"); 
Console.wWriteLine($"Posição: (posicao)"); 


Quando a variável classificacao contém um valor 
diferente de null, seu valor é convertido em inteiro e atribuído 
à variável posicao . Para verificar se a variável contém valor, é 
testada a propriedade HasValue e em seguida é atribuído o valor 
da propriedade Value à variável posicao . 


Confira a seguir a saída gerada por esse exemplo: 





ES CNWINDOWSisystem32icmd.exe — o XxX 


Classificação: ^ 
Posição: 0 } 
Pressione qualquer tecla para continuar. . . m 








Figura 4.1: Testando se um tipo anulável contém valor 


Após descomentar a linha comentada e repetir o teste, veremos 
a saída a seguir: 





E CAWINDOWS\system32\cmd.exe — o DA 
Classificação: 2 A 
Posição: 2 F 

Pressione qualquer tecla para continuar. . . m 








Figura 4.2: Repetindo o teste com a linha de código descomentada 
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Vale destacar que a evolução da linguagem fez com que a 
forma de testar se a variável classificacao possui ou não valor 
também fosse simplificada. Atualmente, podemos realizar o 
mesmo teste desta maneira: 


if (classificacao!= null) { 


posicao = classificacao.Value; 


Ou usando pattern matching introduzido no C# 7: 
if (classificacao is int) { 


posicao = classificacao.Value; 


Bem mais produtivo, não é verdade? 


4.3 UTILIZANDO LITERAIS BINÁRIAS E 
SEPARADORES DE DÍGITOS 


A partir do C# 7, é possível escrever uma literal numérica em 
binário além de hexadecimal. Observe: 


int x = 0b10101010; 


Note que esse recurso é bastante conveniente na definição de 
máscaras de bits, por exemplo. 


Outra melhoria introduzida para tornar números grandes mais 
legíveis é a capacidade de agrupar os dígitos introduzindo 
separadores. Os separadores são inseridos por meio do caractere 
underscore ( _ ) e podem ser usados em literais decimais, 
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hexadecimais e binárias. Veja: 
using System; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
int valorEmDecimal = 1_000_000_000; 
int valorEmHexadecimal = 0x7FFF_2345; 
int valorEmBinario = 0b1001 0110 1010 0101; 
Console.wWriteLine($"valorEmDecimal: (valorEmDecimal)" 
); 
Console.wWriteLine($"valorEmHexadecimal: {valorEmHexad 
ecimal}"); 
Console.WwriteLine($"valorEmBinario: {valorEmBinario}" 
); 
Í 
} 
} 


Obviamente, os separadores de dígitos só servem para facilitar 
a vida do desenvolvedor em tempo de codificação. Eles não afetam 
a saída gerada pelo código: 








E CAWINDOWS\system32\cmd.exe — x 


valorEmDecimal: 1000000000 A 
valorEmHexadecimal: 2147427141 
valorEmBinario: 38565 

Pressione qualquer tecla para continuar. . . 

















Figura 4.3: Utilizando literais binárias e separadores de dígitos 


4.4 CRIANDO MÚLTIPLOS CONSTRUTORES 
DE INSTÂNCIA PARA UMA CLASSE 


Construtores são tipos especiais de métodos usados para criar e 
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inicializar objetos. Eles permitem ao desenvolvedor criar objetos 
da classe, definir valores padrão e limitar a instanciação, dentre 
outras possibilidades. Ao trabalharmos com construtores, é preciso 
ter em mente os seguintes detalhes: 


e Ao criarmos uma classe, um construtor de instância é 
automaticamente criado caso você não o crie de forma 
explícita em seu código. Este construtor é chamado de 
construtor padrão e tem como única função criar uma 
instância da classe. 


e Em Cf, os construtores usam o mesmo identificador que o 
nome da classe e não retornam um valor. Em construtores 
não se utiliza a palavra-chave void. 


e Normalmente utilizamos o modificador de acesso public 
associado ao construtor para que outras classes possam 
instanciar objetos do seu tipo. É possível, entretanto, 
definir um construtor private ou protected para 
realizar tarefas específicas ou impedir que a classe seja 
instanciada. 


e Quando você explicitamente escreve um construtor para 
uma classe, seja ele parametrizado ou não, você perde o 
construtor padrão que é criado automaticamente pelo 
compilador na ausência de um criado de forma explícita. 


e Existem construtores de instâncias e o construtor estático, 
usado para inicializar campos de uma classe que possui 
métodos estáticos. Ao longo desta seção, focaremos apenas 
nos construtores de instância. 


e Toda vez que uma classe é instanciada usando a palavra 
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new , O seu construtor é chamado. 


O construtor padrão de uma classe não possui nenhum 
parâmetro e existe mesmo que você não o veja no seu código: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
public class Pessoa 
{ 
public string Nome { get; set; } 
public string Sexo { get; set; } 
public DateTime DataNascimento { get; set; } 
3 
class Program 
{ 
static void Main(string[] args) 
{ 
Pessoa pessoal = new Pessoa() 
{ 
Nome = "Beltrano de Tal", 
Sexo = "M", 
DataNascimento = new DateTime(1982, 8, 10) 
3; 
3 
3 
} 


No exemplo a seguir, vamos sobrescrevê-lo com um construtor 
definido pela pessoa desenvolvedora: 


using System; 


namespace ProdutividadeEmCSharp 
{ 
public class Pessoa 
{ 
public string Nome { get; set; } 
public string Sexo { get; set; } 
public DateTime DataNascimento { get; set; } 
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public Pessoa() 


{ 
3 
3 
class Program 
{ 
static void Main(string[] args) 
{ 
Pessoa pessoal = new Pessoa() 
{ 
Nome = "Beltrano de Tal", 
Sexo = "M", 
DataNascimento = new DateTime(1982, 8, 10) 
F; 
3 
3 


O construtor desse exemplo não possui código executável e 
existe somente para permitir a instância da classe. Ele pode ser 
inserido digitando o atalho ctor seguido de tab. 


Assim como ocorre com outros métodos, os construtores 
também podem ser sobrecarregados, ou seja, podemos criar mais 
de um construtor para uma mesma classe. O próximo exemplo 
ilustra este cenário: 


using System; 


namespace ProdutividadeEmCSharp 


{ 


public class Pessoa 
{ 
public string Nome { get; set; } 
public string Sexo { get; set; } 
public DateTime DataNascimento { get; set; } 


public Pessoa() 
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3 
public Pessoa(string nome) 
{ 
Nome = nome; 
3 
public Pessoa(string nome, string sexo, DateTime dataNasc 
imento) 
{ 
Nome = nome; 
Sexo = sexo; 
DataNascimento = dataNascimento; 
3 
3 
class Program 
{ 
static void Main(string[] args) 
{ 
Pessoa pessoal = new Pessoa(); 
pessoai.Nome = "Fulano de Tal"; 
pessoai.Sexo = "M"; 
pessoai.DataNascimento = new DateTime(1973, 4, 19); 
Pessoa pessoa2 = new Pessoa() 
{ 
Nome = "Beltrano de Tal", 
Sexo = "M", 
DataNascimento = new DateTime(1982, 8, 10) 
F; 
Pessoa pessoa3 = new Pessoa("Luana de Tal"); 
pessoa3.Sexo = "F"; 
pessoa1.DataNascimento = new DateTime(1990, 2, 22); 
Pessoa pessoa4 = new Pessoa("Mariana de Tal", "F", nei 
DateTime(1994, 7, 17)); 
3 
3 
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Ao observar o código desta listagem, veja que criamos três 
construtores para a classe Pessoa que diferem no número de 
argumentos usados para inicializar o objeto quando a classe for 
instanciada. Compare as formas de inicializar os objetos 
Pessoai, Pessoa2, Pessoa3 e Pessoa4: 


e Pessoal utiliza o construtor sem argumentos. É 
necessário atribuir às linhas posteriores cada uma das 
propriedades de forma individual. Esta é a forma original 
suportada pela linguagem Cf desde a sua criação. 


e Pessoa2 utiliza o construtor sem argumentos e um 
inicializador de objeto para atribuir cada uma das 
propriedades desejadas com menos esforço. Esta forma é 
uma alternativa à sobrecarga de construtores. 


e Pessoa3 utiliza um construtor que recebe como 
parâmetro apenas o atributo Nome . As linhas posteriores 
são usadas para atribuir outras propriedades do objeto. 


e Pessoa4 utiliza um construtor que aceita como 
parâmetro Nome, Sexo e DataNascimento . Todas as 
atribuições necessárias foram feitas usando o próprio 
construtor. Essa forma é mais concisa que a que utiliza 
inicializador de objeto, ainda que menos legível. 


Vale destacar que podemos reduzir o tamanho do código sem 
perder legibilidade, conforme sinalizado na inicialização do objeto 
Pessoa4 . Como o C# passou a suportar parâmetros nomeados, é 
possível reescrever a linha de declaração e inicialização do objeto 
pessoa4 a seguir: 


Pessoa pessoa4 = new Pessoa( "Mariana de Tal", "F", new DateTime(1 
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994, 7, 17)); 
Da seguinte forma: 


Pessoa pessoa4 = new Pessoa(nome:"Mariana de Tal", sexo: "F", dat 
aNascimento: new DateTime(1994, 7, 17)); 


Muito mais legível, não concorda? 


Outra melhoria que pode ser aplicada aos construtores é a 
definição de corpo de expressão (expression body definition) que 
pode ser usada quando o construtor puder ser implementado 
como uma única instrução. Isso quer dizer que este código: 


public Pessoa(string nome) 


{ 


Nome = nome; 


3 
Pode ser implementado desta forma: 
public Pessoa(string nome) => Nome = nome; 


Em resumo, utilizar construtores parametrizados de instância 
juntamente com inicializadores de objetos nos permite simplificar 
a criação de objetos das nossas classes, reduzindo o número de 
linhas de código e o tempo de codificação. 


4.5 DECLARANDO UMA PROPRIEDADE 
AUTOIMPLEMENTADA COMO SOMENTE 
LEITURA OU SOMENTE ESCRITA 


A partir da versão 3.0, a linguagem C# passou a suportar 
propriedades autoimplementadas ou automáticas, o que tornou a 
declaração de uma propriedade muito mais concisa e fácil de ler. 
Em vez de declararmos o código desta forma: 


98 4.5 DECLARANDO UMA PROPRIEDADE AUTOIMPLEMENTADA COMO 
SOMENTE LEITURA OU SOMENTE ESCRITA 


private string nome; 


public string Nome 


{ 


get { return _nome; } 
set { _nome = value; } 


Passamos a usar esta segunda maneira mais concisa: 
public string Nome { get; set; } 


Simples e rápida de codificar, especialmente se você souber que 
digitar "prop" seguido de tab no editor de código do Visual Studio 
fará com que o esqueleto da declaração seja automaticamente 
criado. O nosso trabalho será então substituir o tipo da 
propriedade pelo tipo desejado em cada caso e o nome da 
propriedade. 


Até aqui a maioria dos desenvolvedores já sabe e aplica em sua 
jornada de codificação. O que muitos não sabem é que essa sintaxe 
de propriedades autoimplementadas também suporta a declaração 
de propriedades somente de leitura ou somente de escrita. Para 
declarar uma propriedade como somente leitura, basta configurar 
o escopo do assessor set como private : 


public int Id { get; private set; } 


Ou simplesmente omitir o assessor set da declaração, deste 
modo: 


public int Id { get; } 


Já para declarar uma propriedade como somente escrita, altere 
a visibilidade do assessor get como private . Exemplo: 


public string Log { private get; set; } 
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Nesse caso não é possível remover o assessor get da 
declaração, pois propriedades autoimplementadas requerem a 
presença deste assessor. 


Atribuindo um valor inicial a uma propriedade 
autoimplementada na sua declaração 


As propriedades autoimplementadas também suportam a 
atribuição de um valor inicial no momento da sua declaração. Este 
recurso conhecido como auto-property initializers foi introduzido 
na versão 6.0 da linguagem. Observe a seguir dois exemplos: 


public string Titulo ( get; private set; } = "Produtividade em C& 


f 


public DateTime DataCadastramento { get; private set; } = DateTim 
e. Now; 


Note que, se o seu objetivo é criar uma propriedade somente de 
leitura, é possível ir além e utilizar uma expressão lambda 
conforme mostrado na próxima linha de código: 


public string Nome => "Cláudio Ralha"; 


Utilizando propriedades somente de inicialização 


O C# 9.0 introduziu um recurso conhecido como propriedades 
somente de inicialização (em inglês, init-only properties ou init-only 
setters), que oferece uma sintaxe consistente para inicializar 
membros de um tipo escrito pelo desenvolvedor. Acessadores 

init são usados em propriedades e indexadores no lugar de 
acessadores set para indicar que, após a etapa de inicialização, as 
propriedades se tornam apenas de leitura. 


Isso nos permite fornecer valores iniciais para estas 
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propriedades através de inicializadores de objetos e de construtores 
parametrizados durante a criação do objeto e, em seguida, 
convertê-las em propriedades readonly . 


Para conferir esse comportamento na prática, vamos utilizar o 
código a seguir, que só compilará no compilador do C# 9.0 que 
acompanha o .NET 5.0 ou superior: 


using System; 


namespace ProdutividadeEmCSharp1 


{ 
public class Livro 
{ 
public string Titulo { get; init; } 
public string Autor { get; init; } 
public string Editora { get; init; } 
public int Ano { get; init; } 
public Livro() { 3 
public Livro(string titulo, string autor, string editora, 
int ano) 
{ 
Titulo = titulo; 
Autor = autor; 
Editora = editora; 
Ano = ano; 
3 
3 
class Program 
{ 
static void Main(string[] args) 
{ 
var livrol = new Livro() 
{ 
Titulo = "Segredos do Visual Studio", 
Autor = "Cláudio Ralha", 
Editora = "Digerati", 
Ano = 2004 
3; 


Console.WriteLine($"(livroi.Titulo) - Autor: (livroi. 
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Autor) - Editora: (livroi.Editora) - Ano: (livroi.Ano)"); 

var livroN = new Livro("Produtividade em C&", "Cláudi 
o Ralha", "Casa do Código", 2020); 

Console.wWriteLine($"(livroN.Titulo) - Autor: (livron. 
Autor) - Editora: ([livroN.Editora) - Ano: (livroN.Ano)"); 

//Isto não é permitido 

//livroN.Ano = 2021; 


Ao examinar esse exemplo, observe na classe Livro o uso de 
init nas propriedades definidas. Compile o código com a última 
linha comentada e, a seguir, repita a compilação com ela 
descomentada. Observe que será gerada uma mensagem de erro 
informando que a propriedade de inicialização ou indexador 
Livro.Ano só pode ser atribuída em um inicializador de objeto, 
em this ou base em um construtor de instância ou em um 
acessador init. 


Empregando expressões lambda em propriedades 
calculadas 


Ao escrevermos classes, muitas vezes precisamos criar 
propriedades calculadas como a propriedade Total do exemplo a 
seguir: 


public class Item 
{ 
public int Quantidade { get; set; } 
public double Preco { get; set; } 
public double Total 
{ 
get 
{ 


return Quantidade * Preco; 


} 
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Note que foi necessário escrever um método de apenas uma 
linha de código para calcular o valor Total . Não é algo prático, 
concorda? A partir do C# 6, passamos a utilizar uma forma mais 
concisa conhecida como membro expression bodied, que contém 
somente a expressão, ou seja, sem usar as chaves ou incluir um 
retorno explícito. Veja como fica o exemplo anterior reescrito 
usando essa funcionalidade: 


public class Item 


{ 
public int Quantidade { get; set; } 
public double Preco { get; set; } 
public double Total => Quantidade * Preco; 
} 


Até a introdução desse recurso, só era possível utilizar 
expressões lambdas no corpo de métodos de uma classe. Agora, é 
possível implementar métodos e propriedades somente leitura a 
partir de expressões lambdas. 


4.6 ITERANDO SOBRE UM ENUMERADO 


Em alguns cenários, pode ser necessário percorrer toda a lista 
de constantes de um tipo enumerado, seja para exibir o conjunto 
de nomes, seja para retornar o conjunto de valores. Para ilustrar 
como executar estas ações com o mínimo esforço, vamos partir do 
enum Estacoes : 


public enum Estacao 


{ 


Primavera = 0, 
Verao = 1, 
Outono = 2, 
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Inverno = 3 


A classe Enum fornece a classe base para enumerações e um 
conjunto de métodos, dentre os quais temos o método estático 
Enum.GetNames , usado para recuperar uma matriz dos nomes e 
retornar uma matriz de string dos nomes. Veja no exemplo a 
seguir como é simples utilizá-lo: 


using System; 


namespace ProdutividadeEmCSharp 








{ 
public enum Estacao 
{ 
Primavera = 0, 
Verao = 1, 
Outono = 2, 
Inverno = 3 
3 
class Program 
{ 
static void Main(string[] args) 
{ 
foreach (var item in Enum.GetNames(typeof(Estacao))) 
{ 
Console.writeLine(item); 
3 
3 
3 
3 
Ao executarmos esse código, obteremos a seguinte saída: 
CAWINDOWSisystem32Acmd.exe — E xX 
Primavera A 
Verao 
Outono 


Inverno 
Pressione qualquer tecla para continuar. . . 








Figura 4.4: Listando as constantes de um tipo enumerado 
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Caso deseje recuperar a lista de valores do enum, utilize o 
método estático GetValues da classe Enum e converta os valores 
retornados para inteiros, como mostrado no próximo fragmento 
de código: 


foreach (var item in Enum.GetValues(typeof (Estacao))) 


{ 


Console.writeLine(Convert.ToInt32(item)); 


Confira o resultado na imagem a seguir: 





ES CAWINDOWSisystem32icmd.exe — o xX 


0 
1 
2 
3 
P 


ressione qualquer tecla para continuar. . . 








Figura 4.5: Listando os valores de um tipo enumerado 


4.7 UTILIZANDO INICIALIZADORES DE 
OBJETOS E DE COLEÇÕES 


Ao inicializar valores de propriedade fora da classe, alguns 
desenvolvedores optam por inicializar as propriedades 
separadamente conforme ilustrado no exemplo a seguir: 


using System; 
namespace ProdutividadeEmCSharp 


{ 


public class Pessoa 

{ 
public string Nome { get; set; } 
public int Idade { get; set; } 


public char Sexo { get; set; } 
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} 


class Program 


{ 
static void Main(string[] args) 
{ 
Pessoa pessoa = new Pessoa(); 
pessoa.Nome = "Flavia"; 
pessoa. Idade = 38; 
pessoa.Sexo = 'F'; 
} 
} 


Apesar de funcional, esta maneira é a menos produtiva. Desde 
a versão 3.0, o C# conta com um recurso chamado inicializadores 
de objetos (em inglês, object initializers), que nos permite 
reescrever o trecho de código a seguir: 


Pessoa pessoa = new Pessoa(); 


pessoa.Nome = "Flavia"; 
pessoa. Idade = 38; 
pessoa.Sexo = 'F'; 


da seguinte forma: 


Pessoa pessoa = new Pessoa() { Nome = "Flavia" , Idade = 38, Sexo 
"E 

Ao examinar a linha anterior, perceba que, além de poupar 
uma quantidade significativa de digitação, ainda ganhamos 
legibilidade do código ao optar por esta forma de inicializar as 
propriedades de um objeto. 


Se você ainda não conhecia essa maneira de inicializar objetos 
e gostou da novidade, ficará mais feliz ainda em saber que o Cf 
conta com o recurso de inicializadores de coleção (collection 
initializers) que nos permitem dar um passo além. Veja como é 
simples utilizá-los: 
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List<Pessoa> pessoas = new List<Pessoa> 

{ 
new Pessoa() { Nome = "Flavia" , Idade = 38, Sexo = 'F' }, 
new Pessoa() { Nome "Cláudio" , Idade = 46, Sexo = 'M' } 


J; 


4.8 UTILIZANDO PARÂMETROS OPCIONAIS 
E PARÂMETROS NOMEADOS 


O polimorfismo suportado pelas linguagens orientadas a 
objetos, como o C#, nos permite criar múltiplas versões de um 
método dentro de uma classe, variando apenas a sua assinatura. 
Ao longo da seção sobre construtores parametrizados no início 
deste capítulo, você já viu alguns exemplos de uso de polimorfismo 
e de parâmetros nomeados. A seguir, veremos mais um exemplo, 
só que dessa vez aplicado a métodos normais de instância: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
public static void Escrever(string mensagem) 
{ 
Escrever (mensagem, false, ConsoleColor.Wwhite); 
3 
public static void Escrever (string mensagem, bool capital 
izar) 
{ 
Escrever (mensagem, capitalizar, ConsoleColor.white); 
3 
public static void Escrever (string mensagem, ConsoleColor 
cor) 
{ 
Escrever (mensagem, false, cor); 
3 
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public static void Escrever (string mensagem, bool capital 
izar, ConsoleColor cor) 


{ 
Console.ForegroundColor = cor; 
mensagem = capitalizar ? mensagem.ToUpper() : mensage 
m, 
Console.writeLine(mensagem) ; 
3 


static void Main(string[] args) 


{ 


Console.BackgroundColor = ConsoleColor.Black; 

Console.Clear(); 

Escrever("Produtividade em C&", ConsoleColor.Green); 

Escrever("Cláudio Ralha", false, ConsoleColor.Yellow); 

Escrever ("Aprenda o jeito moderno de programar e extr 
aia o máximo da linguagem em pouco tempo!"); 


3 


No código dessa listagem, temos várias implementações do 
método Escrever . Conforme você pode observar, todas chamam 
internamente a implementação que possui o maior número de 
parâmetros. Ao ser executado, obteremos a seguinte saída: 








EM CNWINDOWSisystem32tcmd.exe = x 











Aprenda o jeito moderno de programar e extraia o máximo da linguagem em pouco tempo! 
Pressione qualquer tecla para continuar. . . 








Figura 4.6: Utilizando parâmetros opcionais e parâmetros nomeados 


Apesar de enxuto, o código desse exemplo pode ser 
simplificado utilizando o recurso de parâmetros opcionais 
introduzido na versão 3.0 da linguagem C#. Esses parâmetros são 
declarados com um valor default que será utilizado caso a 
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desenvolvedora não forneça um valor explícito para ele na 
chamada do método. Observe como ficaria o exemplo anterior 
reescrito de modo a tirar proveito desta funcionalidade: 


using System; 


namespace ProdutividadeEmCSharp 


{ 


class Program 
{ 
public static void Escrever(string mensagem, bool capital 
izar = false, ConsoleColor cor = ConsoleColor.white) 


{ 
Console.ForegroundColor = cor; 
mensagem = capitalizar ? mensagem.ToUpper() : mensage 
m; 
Console.writeLine(mensagem); 
3 
static void Main(string[] args) 
{ 
Console.BackgroundColor = ConsoleColor.Black; 
Console.Clear(); 
Escrever ("Produtividade em C#", false, ConsoleColor.G 
reen); 


Escrever ("Cláudio Ralha", false, ConsoleColor.Yellow); 
Escrever("aprenda o jeito moderno de programar e extr 
aia o máximo da linguagem em pouco tempo!"); 


3 


Ao examinar essa segunda listagem, você observará que o uso 
de parâmetros opcionais simplifica bastante o código-fonte da 
classe, ainda que não resolva todos os cenários. Note que foi 
necessário passar o segundo parâmetro para que pudéssemos 
especificar de forma explícita o terceiro na linha a seguir: 


Escrever ("Produtividade em C&", false, ConsoleColor.Green); 


Se tentarmos utilizar qualquer uma das duas variações a seguir, 
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obteremos um erro de compilação: 


Escrever("Produtividade em C&", , ConsoleColor.Green); 
Escrever("Produtividade em C&", ConsoleColor.Green); 


Para lidar com este tipo de limitação e permitir especificar 
apenas os parâmetros desejados e em ordem variável, foi 
introduzido no C& 4.0 o conceito de parâmetros nomeados. A 
próxima versão do nosso código de teste utiliza este recurso: 


using System; 


namespace ProdutividadeEmCSharp 


{ 


class Program 
{ 
public static void Escrever(string mensagem, bool capital 
izar = false, ConsoleColor cor = ConsoleColor.white) 


{ 
Console.ForegroundColor = cor; 
mensagem = capitalizar ? mensagem.ToUpper() : mensage 
m; 
Console.writeLine(mensagem); 
3 


static void Main(string[] args) 
{ 
Console.BackgroundColor = ConsoleColor.Black; 
Console.Clear(); 
Escrever("Produtividade em C&", cor: ConsoleColor.Gre 
en, capitalizar: false); 
Escrever("Cláudio Ralha", cor: ConsoleColor.Yellow); 
Escrever("aprenda o jeito moderno de programar e extr 
aia o máximo da linguagem em pouco tempo!"); 


3 


Observe que a ordem dos parâmetros foi invertida na linha de 
código a seguir e que é permitido misturar parâmetros nomeados 
com parâmetros não nomeados: 
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Escrever("Produtividade em C&", cor: ConsoleColor.Green, capitali 
zar: false); 


E nesta segunda linha de código, a chamada foi feita 
informando apenas a cor (terceiro parâmetro) sem passar o 
segundo parâmetro (capitalizar), ou seja, especificamos apenas os 
parâmetros que precisávamos utilizar: 


Escrever("Cláudio Ralha", cor: ConsoleColor.Yellow); 


Em resumo, o uso de parâmetros nomeados combinados com 
os parâmetros opcionais tornam o código em desenvolvimento 
mais conciso e legível, aumentando a produtividade e facilitando a 
manutenção. 


4.9 UTILIZANDO MÉTODOS DE EXTENSÃO 
PARA ESTENDER UMA CLASSE 


Métodos de extensão ou extension methods são um recurso 
introduzido na linguagem C# 3.0 para dar suporte a consultas 
LINQ que está disponível para classes e estruturas. Seu uso provê a 
capacidade de estender tipos existentes adicionando novos 
métodos sem a necessidade de modificar o tipo. Note que isso 
significa que podemos acrescentar métodos às classes cujo código 
não podemos manipular diretamente por não o termos disponível, 
e incluir novos métodos em estruturas e classes que não podiam 
ser estendidas pelo mecanismo de herança. 


Para ilustrar como os métodos de extensão funcionam, vamos 
criar métodos extras para a classe string . Veja: 


using System; 
using System.Ling; 
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namespace ProdutividadeEmCSharp 


{ 
public static class MetodosExtensao 
{ 
public static string ObterPrimeiraPalavra(this string val 
or) 
{ 
return valor .Split(null).FirstOrDefault(); 
3 


public static string ObterUltimaPalavra(this string valor 


{ 
return valor .Split(null).LastOrDefault(); 
3 
public static string OrdenarPalavras(this string valor) 
{ 
return OrdenarPalavras(valor,true); 
3 


public static string OrdenarPalavras(this string valor, b 
ool ascendente) 


{ 
var palavras = valor.Split(null); 
Array .Sort(palavras); 
if (ascendente == false) Array.Reverse(palavras); 
return String.Join(" ", palavras); 
) 
public static int ContarPalavras(this String valor) 
{ 
return valor.Split(new char[] { ' ', !.!, '?' }, Stri 
ngSplitOptions .RemoveEmptyEntries).Length; 
} 


} 


class Program 
{ 


static void Main(string[] args) 


£ 


var frase = "Sou brasileiro e não desisto nunca"; 

Console.wWriteLine($"Frase original: {frase}"); 

Console.wWriteLine($"Primeira palavra: (frase.ObterPri 
meiraPalavra())"); 
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Console.writeLine($"Última palavra: (frase.obterUltim 
aPalavra())"); 

Console.wWriteLine($"0Ordenando palavras (Asc): (frase. 
OrdenarPalavras())J"); 

Console.wWriteLine($"0Ordenando palavras (Desc): {fras 
e.OrdenarPalavras(false))"); 

Console.wWriteLine($"Total de palavras: (frase.ContarP 
alavras()}"); 


} 


Ao examinar esse exemplo, considere os seguintes detalhes 
relacionados ao uso de métodos de extensão em Cf: 


e Um método de extensão é sempre estático e deve ser 
definido em uma classe estática. 

e Um método de extensão pode ser apenas uma função que 
retorna ou não um valor. Não é possível definir uma 
propriedade, campo ou evento de extensão. 

e O primeiro parâmetro na definição de um método de 
extensão especifica qual tipo de dado o método estende e 
ele é precedido pelo modificador this. 

e Quando o método é executado, o primeiro parâmetro é 
vinculado à instância do tipo de dados invocada pelo 
método. 


Perceba que a diferença dessa abordagem em relação à 
colocação desses métodos estáticos em uma classe de utilitários é 
que a chamada pode ser feita de forma semelhante à dos métodos 
de instância, apesar de esses métodos não serem de fato membros 
de instância do tipo. Em termos práticos, isso poupa o trabalho de 
lembrarmos onde os métodos estão realmente definidos, além de 
simplificar a sua sintaxe de uso. 
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Confira na imagem a seguir a saída produzida por esse 
exemplo: 





EM CNWINDOWSisystem32Acmd.exe — o sé 


Frase original: Sou brasileiro e não desisto nunca A 
Primeira palavra: Sou 

Última palavra: nunca 

Ordenando palavras (Asc): brasileiro desisto e não nunca Sou 


Ordenando palavras (Desc): Sou nunca não e desisto brasileiro 
Total de palavras: 6 i 
Pressione qualquer tecla para continuar. . . m 











Figura 4.7: Estendendo uma classe com métodos de extensão 


Ao utilizar métodos de extensão em seus projetos, atente-se aos 
seguintes pontos: 


e Os métodos de extensão só estarão no escopo quando você 
importar explicitamente o namespace para seu código- 
fonte com uma diretiva using. 

e Um método de extensão com o mesmo nome e assinatura 
de um método de instância não será chamado. Isso ocorre 
porque os métodos de extensão não podem ser usados para 
substituir os métodos existentes. 


4.10 UTILIZANDO O TIPO DYNAMIC PARA 
RETORNAR OBJETOS DIFERENTES 


Um dos recursos mais interessantes inseridos na linguagem Cf 
é a palavra-chave dynamic , que nos permite, entre outras coisas, 
retornar objetos diferentes em tempo de execução baseado, por 
exemplo, nos parâmetros passados para um método. Em termos 
práticos, isso significa que um mesmo método pode retornar 
vários tipos de objetos, preenchendo uma lacuna deixada até então 
pelo polimorfismo no C#. 
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Ao contrário da palavra-chave var que usamos para inferir o 
tipo da variável baseado no seu valor inicial, dynamic não obtém 
as propriedades e métodos do objeto em tempo de compilação. Ela 
o faz em tempo de execução, o que a torna mais flexível em alguns 
cenários. 


O exemplo a seguir ilustra como usar dynamic no retorno de 
um método: 


using System; 


namespace ProdutividadeEmCSharp 


{ 

class Pessoa 

{ 
public string Nome { get; set; } 
public int Idade { get; set; } 
public char Sexo { get; set; } 

3 

class Autor : Pessoa 

{ 
public string Email { get; set; } 

3 

class Livro 

{ 
public string Titulo { get; set; } 
public int Edicao { get; set; } 
public int Ano { get; set; } 

3 


class Program 
{ 
private static dynamic ObterObjeto(string objeto) 
{ 
switch (objeto.ToLower()) 
{ 
case "pessoa": 
Pessoa pessoa = new Pessoa() { Nome="Flavia", 
Sexo = 'F', Idade= 38}; 
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return pessoa; 
case "autor": 
Autor autor = new Autor() { Nome = "Cláudio", 
Sexo = 'M', Idade = 46, Email = "claudioralhaQhotmail.com" 3; 
return autor; 
case "livro": 
Livro livro = new Livro() { Titulo = "Produti 
vidade em C&", Edicao = 1, Ano = 2020 3; 
return livro; 
default: 
return "Esta opção não é válida"; 


static void Main(string[] args) 
{ 
Pessoa pessoa = ObterObjeto("pessoa"); 
Console.wWriteLine($"Nome: (pessoa.Nome) - Sexo: {pess 
oa.Sexo) - Idade: (pessoa. Idade)"); 
Autor autor = ObterObjeto("autor"); 
Console.wWriteLine($"Nome: (autor.Nome) - Sexo: {autor 
.Sexo) - Idade: (autor.Idade) - Email: {autor .Email}"); 
Livro livro = ObterObjeto("livro"); 
Console.wWriteLine($"Título: (livro.Titulo) - Edição: 
(livro.Edicao) - Ano: (livro.Ano)"); 


3 


Ao examinar o código desta listagem, observe que o método 
oObterobjeto é usado para retornar três tipos diferentes de 
objetos ( Pessoa, Autor e Livro ) com o mínimo de código e 
de forma legível. Confira na imagem a seguir a saída gerada por 
esse exemplo: 





ER CAWINDOWSisystem32Acmd.exe = o xX 


Nome: Flavia - Sexo: F - Idade: 38 A 
Nome: Cláudio - Sexo: M - Idade: 46 - Email: claudioralhaGhotmai1.com 

Titulo: Produtividade em C# - Edição: 1 - Ano: 2020 

Pressione qualquer tecla para continuar. . . m 











Figura 4.8: Utilizando dynamic para retornar objetos de tipos diferentes 
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Para saber mais sobre o uso de dynamic em Cf, consulte a 
seguinte página da documentação oficial: 


https://docs.microsoft.com/pt-br/dotnet/csharp/language- 
reference/keywords/dynamic 





4.11 UTILIZANDO YIELD EM VEZ DE CRIAR 
COLEÇÕES TEMPORÁRIAS 


Com frequência, escrevemos códigos semelhantes ao do 


exemplo a seguir, nos quais criamos coleções temporárias para 


selecionar itens de uma outra coleção. Veja: 


using System; 
using System.Collections.Generic; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


f 


static List<int> ObterNumerosPares(List<int> lista) 


{ 


List<int> listaTemporaria = new List<int>(); 


foreach (int numero in lista) 


t if (numero % 2 == 0) 
{ 
listaTemporaria.Add(numero); 
3 
3 


return listaTemporaria; 


3 


static void Main(string[] args) 


{ 
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List<int> numeros = new List<int>() (0,1,2,3,4,5,6,7, 


,9,103; 
List<int> numerosPares = ObterNumerosPares (numeros); 
foreach (var numero in numerosPares) 
{ 
Console.writeLine(numero); 
3; 
3 
3 
J} 


Ao examinar esse código, observe que criamos a lista 
listaTemporaria do tipo  List<int> no método 
ObterNumerosPares . De fato, não há nada de errado com esse 
exemplo, mas existem formas de obter o mesmo resultado com 
menos código: usando yield ou LINQ para objetos - sobre este 
falaremos no capítulo 7. 


A linguagem C# desde a sua versão 2.0 conta com a palavra- 
chave contextual yield para lidar com cenários como esse. Veja 
na listagem a seguir como fica o exemplo anterior reescrito usando 

yield : 


using System; 
using System.Collections.Generic; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static IEnumerable<int> ObterNumerosPares(List<int> lista 
{ 
foreach (int numero in lista) 
{ 
if (numero % 2 == 0) 
{ 
yield return numero; 
3 
3 
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static void Main(string[] args) 


{ 
List<int> numeros = new List<int>() {0,1,2,3,4,5,6,7, 
9,10}; 
IEnumerable<int> numerosPares = ObterNumerosPares (num 
eros); 
foreach (var numero in numerosPares) 
{ 
Console.writeLine(numero); 
>; 
3 
3 
3 


Confira a seguir a explicação sobre o uso de yield extraída 
da documentação da linguagem C#: 


“Ao usar a palavra-chave contextual yield em uma 
instrução, você indica que o método, o operador ou o 
acessador get em que ela é exibida é um iterador. Usar 
yield para definir um iterador elimina a necessidade de 
uma classe adicional explícita (a classe que mantém o estado 
de uma enumeração, consulte IEnumerator<T> para obter 
um exemplo) ao implementar o padrão IEnumerable e 
IEnumerator para um tipo de coleção personalizado”. 


Importante: uma palavra-chave contextual é usada para 


fornecer um significado específico no código em determinado 


contexto, mas não é uma palavra reservada no Cf. 





Ao serem executados, ambos os programas produzirão a 
seguinte saída: 
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CAWINDOWSisystem32icmd.exe — mi x 


vNENO 


10 
Pressione qualquer tecla para continuar. . . 











Figura 4.9: Utilizando yield em vez de criar uma coleção temporária 


Vale destacar que existem algumas restrições de uso do 
yield . Não é possível incluir uma instrução yield return ou 
yield break em métodos anônimos e em métodos que contêm 

blocos inseguros e também há restrições de uso do yield em 
tratamento de exceções. 


Para obter informações mais detalhadas, restrições de uso e 
outros exemplos de aplicação da palavra-chave yield em 
C#, consulte a seguinte página da documentação oficial: 


https://docs.microsoft.com/pt-br/dotnet/csharp/language- 
reference/keywords/yield 


Para conferir a lista de palavras-chaves contextuais 
suportadas pelo C#, consulte a página a seguir: 


https://docs.microsoft.com/pt-br/dotnet/csharp/language- 


reference/keywords/contextual-keywords 
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4.12 UTILIZANDO DECLARAÇÕES USING 
PARA SINALIZAR OBJETOS DESCARTÁVEIS 


Até o Cf 7.x, é necessário utilizar uma instrução using para 
definir o escopo dos objetos de tipo gerenciado que acessam 
recursos não gerenciados, pois ela garante o uso correto de objetos 
que implementam a interface IDisposable , evitando vazamentos 
de memória, além de manter presos recursos caros como conexões 
com bancos de dados. Veja a seguir um exemplo: 


using System. IO; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void CriarArquivo() 
{ 
using (var arquivo = new StreamWriter ("exemplo.txt")) 
{ 
arquivo.WwriteLine("Produtividade em C#"); 
3 
3 
static void Main(string[] args) 
{ 
CriarArquivo(); 
3 
3 
3 


Ao analisar esse código, note que a instrução using mostra 
de forma explícita quando o recurso será limpo. Isso acontece 
quando a execução do código passa da chave de fechamento. 


A partir do C# 8.0, podemos declarar um objeto descartável 
com a palavra-chave using precedendo a declaração da variável, 
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conforme mostrado na próxima listagem: 
using System. IO; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void CriarArquivo() 
{ 
using var arquivo = new StreamWriter ("exemplo.txt"); 
arquivo.WriteLine("Produtividade em C#"); 
3 
static void Main(string[] args) 
{ 
CriarArquivo(); 
3 
3 
} 


Declarações using são apenas declarações de variáveis locais. 
O objeto criado desta forma será descartado assim que sair do 
escopo, o que ocorre no final do bloco de instruções atual. Nesse 
exemplo, ao terminar a execução do método CriarArquivo . 


Ao comparar as duas formas de se codificar, percebemos que a 
instrução using é mais explícita, oferecendo um controle mais 
preciso em relação à liberação dos recursos, enquanto a declaração 

using se limita a facilitar a leitura por não introduzir um nível 
extra de aninhamento. Pessoalmente, eu prefiro continuar usando 
instruções using. 
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Para saber mais sobre as pequenas diferenças de escopo entre 
a declaração using ea instrução using , recomendamos a 
leitura da documentação oficial e do seguinte artigo do mestre 
Macoratti: 


https://docs.microsoft.com/pt-br/dotnet/csharp/language- 
reference/keywords/using-statement 


http://www.macoratti.net/19/12/c8 usingl.htm 





4.13 UTILIZANDO MÉTODOS DE INTERFACE 
PADRÃO 


O C# 8.0 introduz um novo recurso conhecido como métodos 
de interface padrão (em inglês, default interface methods), que vai 
bagunçar tudo o que você estudou no passado sobre interfaces e 
classes abstratas. 


Os métodos de interface padrão nos permitem fornecer uma 
implementação para membros da interface. Deste modo, quando 
uma classe que implementa a interface não implementar o 
membro de interface especificado, será usado o método padrão da 
própria interface se este possuir um corpo. 


Para entender os motivos que levaram o time de 
desenvolvimento do C& a incluir este recurso controverso na 
linguagem, transcrevemos a justificativa incluída na documentação 
oficial: 
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Esse recurso de linguagem permite que os autores de API 
adicionem métodos a uma interface em versões posteriores sem 
interromper a fonte ou a compatibilidade binária com 
implementações existentes dessa interface. As implementações 
existentes herdam a implementação padrão. Esse recurso 
também permite que o C# interopere com APIs que direcionam 
o Android ou o Swift, que dão suporte a recursos semelhantes. 
Os métodos de interface padrão também habilitam cenários 
semelhantes a um recurso de linguagem de “características”, 


Referência: 
https://docs.microsoft.com/pt-br/dotnet/csharp/whats- 


new/csharp-84default-interface-methods 





Para ilustrar como utilizar métodos de interface padrão, vamos 
imaginar que tenhamos uma interface chamada ILogger , que 
originalmente foi definida como mostrada a seguir: 


public interface ILogger 


{ 


void Info(string mensagem); 
void Error(string mensagem); 


Após ser implementada em algumas classes do sistema, como 
ConsoleLogger e DebugLogger , surgiu a necessidade de 
adicionar um novo método chamado warn . Sem usar o recurso 
de métodos de interface padrão introduzido no Cf 8, teríamos que 
incluir o método warn em todas as classes que implementam a 
interface ILogger conforme demonstrado no próximo exemplo: 
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using System; 


namespace ProdutividadeEmCSharp 


{ 
public interface ILogger 
{ 
void Info(string mensagem); 
void Error(string mensagem); 
void Warn(string mensagem); 
3 


public class ConsoleLogger : ILogger 


{ 


public void Error(string mensagem) 


{ 


Console.wWriteLine($" (mensagem) 
ror da classe ConsoleLogger]"); 


3 


public void Info(string mensagem) 


{ 


Console.WwriteLine($"{mensagem} 
fo da classe ConsoleLogger]"); 


} 


public void Warn(string mensagem) 


{ 


Console.writeLine($"{mensagem} 
classe ConsoleLogger]"); 
3 
3 


public class DebugLogger : ILogger 
{ 


public void Error(string mensagem) 


{ 


Console.WriteLine($" (mensagem) 
ror da classe DebugLogger]"); 


3 


public void Info(string mensagem) 


£ 


Console.wWriteLine($" (mensagem) 


[Executando método Er 


[Executando método In 


[Executando método da 


[Executando método Er 


[Executando método In 
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fo da classe DebugLogger]"); 


3 


public void 


{ 


Console 


Warn(string mensagem) 


WriteLine($"(mensagem) [Executando método wa 


rn da classe DebugLogger]"); 


} 
} 


class Program 


{ 


static void 


Main(string[] args) 


console = new ConsoleLogger(); 
Error("Testando método Error da classe Consol 


Info("Testando método Info da classe Console 
Warn( "Testando método Warn da classe Console 


debug = new DebugLogger(); 


debug.Error("Testando método Error da classe DebugLog 


debug. Info("Testando método Info da classe DebugLogg 


debug.Warn( "Testando método Warn da classe DebugLogg 


{ 
ILogger 
console. 
eLogger!"); 
console. 
Logger!"); 
console. 
Logger!"); 
ILogger 
ger! "); 
er! ") 
er O 
) 
} 
} 


Com o suporte à nova funcionalidade, basta implementar o 


método warn na interface ILogger e sobrescrevê-lo onde de 


fato precisarmos. Para as demais classes, é possível utilizar a 


implementação do método warn existente na interface. Veja: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
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public interface ILogger 


f 


void Info(string mensagem); 
void Error(string mensagem); 


void Warn(string mensagem) 
{ 
Console.writeLine($"{mensagem} 
rn da interface ILogger]"); 
} 
} 


public class ConsoleLogger : ILogger 


{ 


public void Error(string mensagem) 


{ 


Console.wWriteLine($" (mensagem) 
ror da classe ConsoleLogger]"); 


3 


public void Info(string mensagem) 


{ 


Console.writeLine($"{mensagem} 
fo da classe ConsoleLogger]"); 
3 
3 


public class DebugLogger : ILogger 
{ 


public void Error(string mensagem) 


{ 


Console.wWriteLine($" (mensagem) 
ror da classe DebugLogger]"); 


3 


public void Info(string mensagem) 


{ 


Console.WriteLine($" (mensagem) 
fo da classe DebugLogger]"); 
3 


public void Warn(string mensagem) 


£ 


Console.WriteLine($" (mensagem) 


[Executando método wa 


[Executando método Er 


[Executando método In 


[Executando método Er 


[Executando método In 


[Executando método wa 
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rn da classe DebugLogger]"); 


3 


class Program 


£ 


static void Main(string[] args) 
{ 
ILogger console = new ConsoleLogger(); 
console.Error("Testando método Error da classe Consol 
eLogger!"); 
console.Info("Testando método Info da classe Console 


Logger!"); 

console.wWarn("Testando método Warn da classe Console 
Logger!"); 

ILogger debug = new DebugLogger(); 

debug.Error("Testando método Error da classe DebugLog 
ger! "); 

debug. Info("Testando método Info da classe DebugLogg 
err 7j; 

debug.Warn( "Testando método Warn da classe DebugLogg 
eri “9 

3 
3 

} 


Confira na imagem a seguir a execução do método warn da 
interface ILogger (terceira linha): 





EM CAWINDOWS\system32\cmd.exe = o x 
Testando método Error da classe ConsoleLogger! [Executando método Error da classe ConsoleLogger] A 
Testando método Info da classe ConsoleLogger! [Executando método Info da classe ConsoleLogger] 
Testando método Warn da classe ConsoleLogger! [Executando método Warn da interface og 
[Testando método Error da classe DebugLogger! [Executando método Error da classe Debuglogger] 

Testando método Info da classe DebuglLogger! [Executando método Info da classe Debuglogger] 
Testando método Warn da classe DebugLogger! [Executando método warn da classe DebugLogger] 


Pressione qualquer tecla para continuar. . 











Figura 4.10: Executando o método warn definido na interface ILogger 


Como curiosidade, saiba que essa funcionalidade já estava 
disponível em nível de linguagem MSIL há muitos anos, mas não 
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era possível tirar proveito dela em C& diretamente, apenas via 
reflection. 


Com a chegada do Cf 8.0, a implementação de membros de 
interface passou a ser suportada pelo compilador. 


Este recurso será visto por alguns como uma benção, já que 
será conveniente e realmente útil em muitos cenários, e por outros 
como uma maldição, pois distorce a funcionalidade planejada para 
as classes de implementação. Isso porque ele permite alterar a 
assinatura da interface, fazendo com que as classes de 
implementação ganhem novas funcionalidades injetadas, que 
podem não fazer sentido ou, em casos mais extremos, gerar 
conflitos com algo presente na classe de implementação. 


Como já dizia o velho ditado, "a diferença entre o remédio e o 
veneno está na dose”. Portanto, procure analisar cada caso e 
utilizar este recurso com moderação, lembrando que as classes 
abstratas continuam disponíveis na linguagem. 


Para um estudo mais avançado sobre métodos de interface 
padrão, recomendamos a leitura dos seguintes tutoriais: 


https://docs.microsoft.com/pt- 
br/dotnet/csharp/tutorials/default-interface-methods- 
versions 


https://docs.microsoft.com/pt- 


br/dotnet/csharp/tutorials/mixins-with-default-interface- 
methods 
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4.14 INICIALIZANDO OBJETOS USANDO 
NEW EXPRESSIONS 


Desde o C# 1.0, nós nos acostumamos a instanciar objetos 
usando a sintaxe a seguir: 
Pessoa pessoal = new Pessoa(); 
Pessoa pessoa2 = new Pessoa("Cláudio","Ralha"); 


O C& 3.0 nos trouxe a inferência de tipo e evoluímos para esta 
forma mais elegante: 


var pessoa3 = new Pessoa("Iara","Ralha"); 


Com a chegada do C& 9.0, passamos a contar com uma nova 
forma de instanciar objetos conhecida como new expressions, um 
recurso que permite simplificar a escrita de instruções de criação 
de objetos. Em termos práticos, a funcionalidade torna possível 
eliminar o uso do nome das classes após a palavra-chave new 
desde que tenhamos especificado o nome do tipo no início da 
linha. Isso nos permite reescrever o exemplo inicial desta forma: 


Pessoa pessoal = new(); 
Pessoa pessoa2 = new("Cláudio","Ralha"); 


Obviamente, a nova funcionalidade não é permitida com a 
palavra var . A linha a seguir impedirá o programa de compilar: 


var pessoa3 = new("Iara","Ralha"); 


Perceba que nesse caso não há como o compilador inferir que 
classe o desenvolvedor deseja utilizar. Para conferir o uso do novo 
recurso na prática, execute o exemplo a seguir. Note que os nomes 
dos personagens usados neste exemplo pertencem à tragédia 
Romeu e Julieta de William Shakespeare, escrita entre 1591 e 1595: 
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namespace ProdutividadeEmCSharp9 


{ 


public class Pessoa 


{ 


public 
public 


public 
public 


public 


string PrimeiroNome { get; set; } 
string UltimoNome { get; set; } 


int Idade { get; set; } 
Pessoa() { 1 


Pessoa(string primeiroNome, string ultimoNome) 


{ 


PrimeiroNome = 
UltimoNome = 


primeiroNome; 
ultimoNome; 


public Pessoa(string primeiroNome, string ultimoNome, int 


idade) => (PrimeiroNome, UltimoNome, Idade) = (primeiroNome, ult 
imoNome, idade); 
} 
class Program 
{ 
static void Main(string[] args) 
{ 
//Antes do C# 9.0: 
Pessoa pessoal = new Pessoa(); 
pessoa1.PrimeiroNome = "Romeu"; 
pessoa1.UltimoNome = "Montéquio"; 
pessoa1.Idade = 17; 
Pessoa pessoa2 = new Pessoa("Teobaldo", "Capuleto"); 


Pessoa pessoa3 = 


Pessoa pessoa4 = 
UltimoNome = 
//A partir do C& 9.0 
Pessoa pessoa5 = 
pessoa5.PrimeiroNome 
pessoa5.UltimoNome = 
pessoa5. Idade = 17; 
Pessoa pessoa6 = new 
Pessoa pessoa? = new 


new 
ta”, 


"Capuleto", Idade = 


Pessoa( "Julieta", "Capuleto",13) 


Pessoa() { PrimeiroNome = "Julie 
13 }; 


new(); 


= "Romeu"; 
"Montéquio"; 


("Teobaldo", 
("Julieta", 


"Capuleto"); 
"Capuleto", 13); 


timoNome 


Pessoa pessoa8 = new() { PrimeiroNome = 
"Capuleto", Idade = 13 }; 
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"Julieta", 


Ul 
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Apesar de não ser algo que implique em uma mudança 
significativa na forma como desenvolvemos e em um ganho de 
produtividade real como ocorreu com o uso do var , essa 
funcionalidade envolve uma nova forma de instanciar objetos que 
será certamente explorada em provas de certificação e de processos 
seletivos para o mercado de trabalho. Particularmente, prefiro 
continuar utilizando o nome da classe após a palavra new , mas é 
uma questão de gosto pessoal e não de obrigatoriedade. 


4.15 UTILIZANDO REGISTROS PARA CRIAR 
TIPOS DE REFERÊNCIA IMUTÁVEIS 


O principal recurso introduzido no Cf 9.0 são os registros (em 
inglês, records) usados para permitir que objetos inteiros sejam 
imutáveis e se comportem como tipos de valor. Eles fazem uso das 
propriedades somente de inicialização, abordadas anteriormente, 
que permitem tornar as propriedades individuais imutáveis. 


Tipos de registro são tipos de referência, semelhantes a classes, 
mas definidos usando a palavra-chave record . Veja um exemplo: 


using System; 


namespace ProdutividadeEmCSharp9 


{ 


public record Pessoa 


{ 
public string PrimeiroNome { get; init; } 
public string UltimoNome { get; init; } 


public Pessoa() { } 
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public Pessoa(string primeiroNome, string ultimoNome) => 
(PrimeiroNome, UltimoNome) = (primeiroNome, ultimoNome); 


3 


class Program 


£ 


static void Main(string[] args) 


{ 


Pessoa pessoal = new Pessoa("Cláudio", "Ralha"); 

Console.WwriteLine($"0lá, {pessoa1.PrimeiroNome} {pess 
oa1.UltimoNome}!"); 

//Só para lembrar, isto gera erro 

//pessoa1.PrimeiroNome = "Iara"; 


Ao analisar rapidamente esse código, a única diferença 
aparente que encontraremos é a substituição da palavra-chave 
class por record , certo? Pois saiba que apenas com registros 
podemos reduzir a declaração de um tipo a uma única linha. Veja: 


namespace ProdutividadeEmCSharp9 


5 public record Pessoa (string PrimeiroNome, string UltimoNome) 
r 
class Program 
{ 
static void Main(string[] args) 
{ 
Pessoa pessoal = new Pessoa("Cláudio", "Ralha"); 
3 
3 
} 


Essa declaração de registro que torna as propriedades 
declaradas automaticamente somente de inicialização, por si só, já 
será suficiente para fazer com que muitos desenvolvedores 
queiram migrar imediatamente para o C# 9 e o .NET 5. Mas para 


4.15 UTILIZANDO REGISTROS PARA CRIAR TIPOS DE REFERÊNCIA IMUTÁVEIS 
133 


entender por que registros nos serão verdadeiramente úteis no dia 
a dia, vamos ver como eles se comportam em relação à cópia, à 
herança e à comparação de objetos. 


Em muitos casos, desejamos criar um novo objeto a partir de 
outro, uma vez que alguns valores de propriedade são idênticos. 
Para estes cenários, o Cá 9.0 disponibiliza a palavra-chave with. 
Ela nos permite criar um objeto a partir de outro, especificando 
quais alterações de propriedade desejamos efetuar. Observe: 


static void Main(string[] args) 


{ 


Pessoa pessoal = new Pessoa("Cláudio", "Ralha"); 
Pessoa pessoa2 = pessoal with ( PrimeiroNome = "Iara" 3; 


Para entender como isso se tornou tão fácil, segue a explicação 
do time de desenvolvimento da Microsoft: 


"Os registros possuem um método virtual oculto que é 
encarregado de “clonar” todo o objeto. Todo tipo de registro 
derivado substitui esse método para chamar seu construtor de 
cópia. Esse construtor de cópia se encadeia ao construtor de 
cópia do registro base. Uma expressão with simplesmente 
chama o método clone oculto e aplica o inicializador de 
objeto ao resultado." (Em tradução livre de 


https://devblogs.microsoft.com/dotnet/welcome-to-c-9-0/) 





Os registros, assim como as classes, oferecem suporte à herança 
simples de implementação. Ao criar registros em C%, tenha em 
mente as seguintes regras: 
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e Os registros não podem herdar de classes (com exceção da 
classe object ) e as classes não podem herdar de registros. 
e Os registros podem ser herdados de outros registros. 


O próximo exemplo ilustra o uso de herança com registros: 
using System; 


namespace ProdutividadeEmCSharp9 
{ 
public record Pessoa 
{ 
public string PrimeiroNome { get; } 
public string UltimoNome { get; } 


public Pessoa() { } 


public Pessoa(string primeiroNome, string ultimoNome) => 
(PrimeiroNome, UltimoNome) = (primeiroNome, ultimoNome); 


} 


public record Autor : Pessoa 
{ 


public string Pseudonimo { get; } 


public Autor(string primeiroNome, string ultimoNome, stri 
ng pseudonimo) 


base(primeiroNome, ultimoNome) => Pseudonimo = pseu 
donimo; 


} 


class Program 

{ 
static void Main(string[] args) 
{ 

Autor autora = new Autor("Agatha", "Christie", "Mary 
westmacott"); 

Console.WwriteLine($"{autora.PrimeiroNome} {autora.Ult 
imoNome} possui mais de 80 obras publicadas e é a mais prolífica 
escritora de romances policiais da literatura. Além das obras pol 
iciais, (autora.PrimeiroNome) também é autora de doze peças de tea 
tro e de seis romances de época que foram assinados com o pseudôn 
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imo de (autora.Pseudonimo), o primeiro publicado em 1930 e o sext 
o em 1956."); 


3 


No construtor da classe Autor , veja a chamada ao construtor 

da classe base Pessoa para popular as propriedades 

PrimeiroNome e UltimoNome e a atribuição de valor da 
propriedade Pseudonimo declarada na própria classe Autor . 


Em termos de comparação de objetos, registros funcionam 
como structs, pois substituem o método virtual Equals para 
permitir a comparação baseada em valor. Isso significa que cada 
propriedade será comparada com uma abordagem baseada em 
valor. Para comprovar, execute o próximo exemplo: 


using System; 


namespace ProdutividadeEmCSharp9 


{ 


public record Pessoa (string PrimeiroNome, string UltimoNome) 


class Program 
{ 
static void Main(string[] args) 
{ 
Pessoa pessoal = new Pessoa("Cláudio", "Ralha"); 
Pessoa pessoa2 = new Pessoa("Cláudio", "Ralha"); 
Pessoa pessoa3 = new Pessoa("Iara", "Ralha"); 
Console.writeLine("Usando Equals:"); 
Console.wWriteLine($"pessoaíi e pessoa2: (pessoai.Equal 
s(pessoa2)+"); 
Console.wWriteLine($"pessoaíi e pessoa3: (pessoai.Equal 
s(pessoa3)+"); 


Console.writeLine("Usando ==:"); 

Console.wWriteLine($"pessoai e pessoa2: (pessoal == pe 
ssoa2)"); 

Console.wWriteLine($"pessoai e pessoa3: (pessoal == pe 
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ssoa3)"); 


3 


Conforme você deve ter percebido em nossa rápida abordagem 
sobre o tema, o uso de registro pode tornar a tarefa de codificação 
muito mais simples e é algo que merece um estudo aprofundado. A 
documentação disponível ainda é escassa, mas isso deve mudar em 
pouco tempo. 


Importante: ao pesquisar sobre essa funcionalidade, você 
encontrará postagens e artigos mais antigos nos quais aparece 
a palavra-chave data no lugar de record . Para saber mais 
sobre registros, acesse: 


https://docs.microsoft.com/pt-br/dotnet/csharp/whats- 


new/csharp-9grecord-types 





Ao longo deste extenso capítulo, foram apresentados a você 
alguns recursos da linguagem C# que são desconhecidos para 
muitos desenvolvedores e desenvolvedoras, incluindo pessoas que 
possuem anos de estrada. As funcionalidades que abordamos vão 
ajudar você a resolver problemas complexos do dia a dia de forma 
inteligente e rápida, pois elas surgiram como respostas para 
dificuldades levantadas pelo time de desenvolvimento do C& e por 
outros desenvolvedores da comunidade técnica. 


4.15 UTILIZANDO REGISTROS PARA CRIAR TIPOS DE REFERÊNCIA IMUTÁVEIS 
137 


CarírtuLO 5 


TUPLAS 


Uma tupla (em inglês, tuple) é uma estrutura de dados que 
contém uma sequência de elementos de diferentes tipos de dados. 
Ela pode ser usada onde você deseja ter uma estrutura de dados 
para manter um objeto com propriedades, e se você não deseja 
criar um tipo separado para ela. 


O suporte a tuplas foi introduzido no Framework .NET 4.0 
através da classe Tuple<T> . Contudo, até o lançamento da versão 
7.0 do C#, as tuplas eram ineficientes e não tinham nenhum 
suporte de linguagem, o que acabava desencorajando o seu uso. 
Dentre as desvantagens, a que mais incomodava era que os 
elementos de tupla do framework .NET 40 só podiam ser 
referenciados como Itemi, Item2 e assim por diante. 


Com o suporte nativo da linguagem para tuplas incluído no C& 
7.0, o desenvolvedor passou a dispor de nomes semânticos para os 
campos de uma tupla, usando tipos de tuplas novos e mais 
eficientes. 


As principais vantagens oferecidas pelo emprego de tuplas em 
nosso código são as seguintes: 


e Representar um conjunto único de dados com acesso fácil e 
manipulação do conjunto. 
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e Retornar múltiplos valores de um método sem usar 
parâmetros out. 

e Passar múltiplos valores para um método usando um único 
parâmetro. 


Ao longo deste capítulo, aprenderemos como tirar proveito 
deste poderoso recurso suportado pela linguagem Cf. Iniciaremos 
estudando como retornar múltiplos valores de um método usando 
uma tupla. A seguir, aprenderemos como passar múltiplos valores 
para um método usando uma tupla ou lista de tuplas. Em seguida, 
demonstraremos como desconstruir os elementos de uma tupla e 
de uma classe. O capítulo termina apresentando como descartar 
retornos de métodos e parâmetros out. 


Habilitando as tuplas do C# 7 


Para usar a segunda geração de tuplas em seus programas, é 
necessário incluir o pacote System.ValueTuple através do 
gerenciador de pacotes NuGet. Isso é feito executando os seguintes 
passos: 


1. Clique no menu Ferramentas do Visual Studio, selecione 
Gerenciador de Pacotes do NuGet e, a seguir, a opção 
Gerenciar Pacotes do NuGet para a Solução. 


2. Clique na guia Procurar do gerenciador de pacotes e pesquise 
por System.ValueTuple . Clique no item encontrado na 
lista da esquerda e, a seguir, no botão Instalar no painel da 
direita. 


3. A caixa de diálogos Visualizar Alterações será exibida. Clique 
no botão Ok para avançar. 
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4. Ao final da instalação, feche o gerenciador de pacotes 
clicando no botão de fechar existente na guia. 


ImportANTE: a classe Tuple do .NET 4.0, mencionada 
anteriormente, continua existindo no framework, mas não 
será utilizada nos exemplos deste capítulo. A diferença é que 

System.ValueTuple é um tipo de valor (struct) enquanto 


System. Tuple é um tipo de referência (classe). 


System.ValueTuple expõe seus itens por meio de campos 
no lugar de propriedades. 





5.1 RETORNANDO MÚLTIPLOS VALORES DE 
UM MÉTODO USANDO UMA TUPLA 


Iniciaremos o nosso estudo sobre tuplas, criando um exemplo 
simples no qual temos uma tupla sem nome e uma tupla nomeada. 
Compare: 


using System; 


namespace ProdutividadeEmCSharp 
{ 
class Program 
{ 
static void Main(string[] args) 
{ 
var casal1 = ("Eduardo", "Mônica"); 
var casal2 = (Esposo: "Cláudio", Esposa: "Flávia"); 
Console.WwriteLine($"Casal 1 -> Esposo: {casal1.Item1} 
Esposa: {casal1.Item2}"); 
Console.WwriteLine($"Casal 2 -> Esposo: (casal2.Esposo 
} Esposa: {casal2.Esposa}"); 


} 
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A tupla casali foi inicializada usando constantes literais e 
não terá nomes de elementos criados usando as projeções de nome 
de campo de tupla no C& 7.1. Logo, para acessar seus itens 
utilizamos Itemi ou Item2.Já a tupla casal2 , conhecida 
como tupla nomeada, fornece nomes melhores para cada campo. 


Note que ainda podemos nos referir aos elementos de uma 
tupla nomeada como Item1i, Item2 etc., mas fornecer nomes a 
cada elemento que criamos torna o seu uso muito mais produtivo. 


Veja a seguir a saída gerada pelo exemplo anterior: 





ER CAWINDOWS\system32\cmd.exe - o x 


Casal 1 -> Esposo: Eduardo Esposa: Mônica A 
Casal 2 -> Epoo Cláudio Esposa: Flávia 
Pressione qualquer tecla para continuar. . . 








Figura 5.1: Acessando os itens das tuplas 


Os nomes de campo para uma tupla a partir do C# 7.1 podem 
ser fornecidos por meio das variáveis usadas para inicializar a 
tupla. Isso é conhecido como inicializadores de projeção de tupla. 
O código da listagem a seguir ilustra este cenário: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
var titulo = "A volta dos que não foram"; 
var autor = "Jacinto Volta"; 
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var filme = (titulo, autor); 
Console.wWriteLine($"Filme: (filme.titulo) Autor: (fil 
me.autor)"); 





3 
3 
} 
Confira a saída produzida por esse exemplo na janela a seguir: 
E CAWINDOWS\system32\cmd.exe — o xX 
Filme: A volta dos que não foram Autor: Jacinto Volta A 


Pressione qualquer tecla para continuar. . 








Figura 5.2: Referenciando os itens de uma tupla pelo nome 


No próximo exemplo, utilizamos uma tupla nomeada para 
retornar mais de um valor de um método: 


using System; 
using System.Collections.Generic; 


namespace ProdutividadeEmCSharp 


{ 


static class Matematica 
{ 
static internal(int Minimo, int Maximo) ObterMinimoMaximo 
(List<int> lista) 


{ 
int max = int.MinValue; 
int min = int.MaxValue; 
lista.ForEach(n =>{ 
min = n < min ? n : min; 
max = n > max ? n : max; 
H; 
return (min, max); 
} 


class Program 


i 


static void Main(string[] args) 
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var numeros = new List<int>() { 22, 5, 78, 45, 89, 17 
J; 


var resultado = Matematica.0ObterMinimoMaximo (numeros) 


Console.wWriteLine($"Mínimo: (resultado.Minimo) Máximo 
: (resultado.Maximo)"); 





3 
3 
} 
Observe na próxima imagem a saída produzida por este 
exemplo: 
E CAWINDOWS\system32\cmd.exe — o x 
Minimo: 5 Máximo: 89 A 


Pressione qualquer tecla para continuar. . . 


v 








Figura 5.3: Retornando o menor e o maior valor de uma lista de inteiros usando uma tupla 
nomeada 


5.2 PASSANDO MÚLTIPLOS VALORES PARA 
UM MÉTODO USANDO TUPLAS 


Assim como podemos ter uma tupla como valor de retorno, 
também podemos ter como um dos parâmetros de um método 
uma tupla, uma lista ou um array de tuplas. 


O primeiro exemplo desta seção ilustra como passar uma tupla 
como parâmetro para um método: 


using System; 
using System.Collections.Generic; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


{ 
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static void Listar((int, int, int, int, int, int,int) res 
ultado) 


{ 
var (concurso, d1, d2, d3, d4, d5,d6) = resultado; 
Console.WwriteLine($"Resultado do concurso: {concurso} 
); 
Console.writeLine($"Dezenas sorteadas : {d1} - {d2 
} - {d3} - {d4} - {d5} - {d6}"); 
3 
static void Main(string[] args) 
{ 
var resultado = (1526, 4,9,16,34,38,45); 
Listar (resultado); 
3 


Ao analisar esse código, você verá que usamos a técnica de 
desconstrução na linha a seguir para tornar o código das linhas 
posteriores mais simples e legível: 


var (concurso, di,d2,d3,d4,d5,d6) = resultado; 


Confira o resultado da execução desse exemplo na próxima 
imagem: 





ER CAWINDOWS\system32\cmd.exe — o xX 


Resultado do concurso: 1526 ^ 
Dezenas sorteadas TAS Ge e e a 
Pressione qualquer tecla para continuar. . . 











Figura 5.4: Passando múltiplos valores para um método usando uma tupla 


Neste segundo exemplo, demonstramos como criar uma lista 
de tuplas, inicializá-la e em seguida passá-la como parâmetro para 
um método. Veja: 


using System; 
using System.Collections.Generic; 
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namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Listar(List<(string, string, string)> palavra 
s) 
{ 
Console.wWriteLine($"Português - Inglês - Espanhol"); 
foreach (var (portugues, ingles, espanhol) in palavra 
s) 
{ 
Console.WriteLine($"{portugues} - {ingles} - {esp 
anhol}"); 
3 
3 
static void Main(string[] args) 
{ 
var palavras = new List<(string, string, string)> 
{ 
("garfo", "fork", "tenedor"), 
("façca”, "knife"; "cuchillo”), 
("colher", "Spoon","cuchara") 
J; 
Listar (palavras); 
3 
3 
3 


Observe que também usamos a técnica de desconstrução no 
loop foreach do método Listar para simplificar o código. Ao 
ser executado, esse exemplo produz a saída mostrada a seguir: 





EH CAWINDOWSisystem32Acmd.exe - a X 


Português - Inglês - Espanhol A 
arfo - fork - tenedor 

aca - knife - cuchillo 

colher - Spoon - cuchara 

Pressione qualquer tecla para continuar. . . m 











Figura 5.5: Passando múltiplos valores para um método usando uma lista de tuplas 
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5.3 DESCONSTRUINDO OS ELEMENTOS DE 
UMA TUPLA 


As tuplas do C# 7 contam com um interessante recurso 
conhecido como desconstrução que nos permite desmontar os 
elementos de uma tupla e acessá-los através de variáveis 
independentes. O exemplo a seguir demonstra o uso desta 
funcionalidade: 


using System; 
using System.Collections.Generic; 


namespace ProdutividadeEmCSharp 
{ 
static class Matematica 
{ 
static internal (int Minimo, int Maximo) ObterMinimoMaxim 
(List<int> lista) 


{ 
int max = int.MinValue; 
int min = int.MaxValue; 
lista.ForEach(n => { 
min = n < min ? n : min; 
max = n > max ? n : max; 
H); 
return (min, max); 
} 
} 
class Program 
{ 
static void Main(string[] args) 
{ 
var numeros = new List<int>() { 22, 5, 78, 45, 89, 17 
J; 
var (minimo, maximo) = Matematica.ObterMinimoMaximo (nu 
meros); 
Console.WwriteLine($"MÍnimo: (minimo) Máximo: {maximo} 
); 
} 
} 
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A desconstrução ocorre nesta linha: 
var (minimo, maximo) = Matematica.0ObterMinimoMaximo (numeros); 


Na linha seguinte é possível observar como ela simplifica o 
código: 
Console.WriteLine($"Mínimo: (minimo) Máximo: (maximoJ"); 

E o melhor de tudo é que não é necessário fornecer uma 
variável para cada um dos parâmetros retornados pelo método se 


você não pretende utilizar todos. Você pode informar o caractere 
— para ignorar cada campo que não utilizará. Veja: 


static void Main(string[] args) 


{ 
var numeros = new List<int>() { 22, 5, 78, 45, 89, 17 }; 
var (minimo, |) = Matematica.0ObterMinimoMaximo (numeros); 
Console.writeLine($"Mínimo: (minimoJ"); 

} 


Este recurso é conhecido como descarte e será tratado em mais 
detalhes após falarmos sobre o uso da desconstrução em classes. 


5.4 DESCONSTRUINDO OS ELEMENTOS DE 
UMA CLASSE 


Na seção anterior, vimos que a desconstrução nos permite 
desmembrar uma tupla em variáveis. A boa notícia para quem 
gostou dessa abordagem é que é possível utilizar a desconstrução 
com outros tipos. Para oferecer suporte à desconstrução, basta que 
o tipo implemente o método Deconstruct apenas com 
parâmetros out . Veja a seguir um exemplo: 


using System; 
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namespace ProdutividadeEmCSharp 


{ 
class Pessoa 
{ 
public string Nome { get; set; } 
public int Idade { get; set; } 
public void Deconstruct(out string nome, out int idade) 
{ 
nome = Nome; 
idade = Idade; 
3 
3 
class Program 
{ 
static void Main(string[] args) 
{ 
Pessoa autor = new Pessoa() { Nome = "Cláudio Ralha", 
Idade = 47}; 
//Aplicando a desconstrução 
var (nome, idade) = autor; 
Console.wWriteLine($"0 autor (nome) tem (idade) anos." 
); 
3 
3 
} 


Um detalhe a ser notado é que podemos implementar essa 
funcionalidade para classes de terceiros empregando um método 
de extensão. A versão alterada do exemplo anterior mostrada a 
seguir simula este cenário: 


using System; 


namespace ProdutividadeEmCSharp 


{ 


public class Pessoa 


{ 
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public string Nome { get; set; } 


public int Idade ( get; set; } 
3 


public static class PessoaExtensoes 
{ 
public static void Deconstruct(this Pessoa pessoa, out st 
ring nome, out int idade) 
{ 
nome = pessoa.Nome; 
idade = pessoa. Idade; 


class Program 


{ 
static void Main(string[] args) 
{ 
Pessoa autor = new Pessoa() { Nome = "Cláudio Ralha", 
Idade = 47}; 
//Aplicando a desconstrução 
var (nome, idade) = autor; 
Console.wWriteLine($"0 autor (nome) tem (idade) anos." 
); 
3 
3 


Desse modo, é possível tornar mais simples o uso de uma 
classe por meio de desconstrução, mesmo quando não se tem 
acesso ao seu código-fonte. 


5.5 DESCARTANDO RETORNOS DE 
MÉTODOS E PARÂMETROS OUT 


Por vezes, o desenvolvedor pode desejar ignorar o resultado de 
um método. Isso é uma tarefa simples quando se trata do valor de 
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retorno do método, pois basta ignorá-lo como no exemplo: 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
private static int ObterValor() => 45; 
static void Main(string[] args) 
{ 
var valor = ObterValor(); 
ObterValor(); 
3 
3 
} 


Nesse exemplo, temos duas chamadas ao método 


` 


ObterValor . Na primeira, atribuímos o valor de retorno 


M A 


variável valor . Na segunda chamada, o valor de retorno não 
associado a nenhuma variável e é consequentemente descartado. 


Enquanto ignorar o valor de retorno de um método sempre foi 
uma tarefa trivial em C#, fazer o mesmo com uma variável out 
antes do C# 7.0 não era algo simples, uma vez que a associação era 
obrigatória. Veja a seguir um exemplo: 


namespace ProdutividadeEmCSharp 


{ 


class Program 


{ 
private static void ObterValor(out int valor) => valor = 
46; 


static void Main(string[] args) 


í 
int resultado; 
ObterValor (out resultado); 
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O C& 7.0 introduziu as variáveis out , que permitem que o 
código anterior seja reescrito da seguinte forma: 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
private static void ObterValor(out int valor) => valor = 
46; 
static void Main(string[] args) 
{ 
ObterValor(out var resultado); 
3 
3 
} 


Note que, mesmo neste caso, continuamos tendo uma variável 
sendo introduzida e associada, ainda que usando menos código. 
Felizmente, outro recurso incluído no C# 7 pode ser empregado 
para eliminar esse incômodo: descartes (em inglês, discards). O 
caractere underscore ( _ ) é usado para indicar cada ocorrência do 
parâmetro ou variável que deve ser ignorado. 


Você já o viu em funcionamento na seção anterior quando 
explicamos a desconstrução de tupla. Ele nos permite fazer algo 
como mostrado no próximo exemplo: 


using System; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


£ 
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static void Main(string[] args) 





t 
var tupla = (1, 2, 4, 8, 16, 32); 
(_, var segundo, _, ., var quinto, _) = tupla; 
Console.WwriteLine($"Segundo valor da Tupla: {segundo} 

); 

Console.WwriteLine($"Quinto valor da Tupla: {quinto}") 

i 

} 
} 
} 
Ao ser executado, esse código produzirá a seguinte saída: 

ES CAWINDOWS\system32\cmd.exe — o xX 
Segundo valor da Tupla: 2 A 
Quinto valor da Tupla: 16 
Pressione qualquer tecla para continuar. . . m 

v 








Figura 5.6: Descartando valores desnecessários durante a desconstrução de uma tupla 


No contexto das variáveis out , utilizamos o descarte 
conforme mostrado no exemplo da próxima listagem: 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
private static void ObterValor(out int valor) => valor = 
45; 
static void Main(string[] args) 
{ 
ObterValor (out int ); 
3 
3 
3 


Note que é permitido inclusive descartar o tipo da variável, ou 
seja, a linha a seguir: 
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ObterValor(out int ); 
Para ser reescrita da seguinte forma: 
ObterValor(out _); 


Como curiosidade, saiba que também podemos utilizar esse 
recurso para descartar uma variável. Veja: 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
_=5 +10; 
3 
3 
3 


Obviamente, não é possível ler o valor atribuído ao underscore. 
Se você tentar, obterá um erro de compilação. Experimente: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
= 5 + 10; 
Console.WwriteLine($" Valor de _: {_}"); 
3 
3 
} 


Ao tentar compilar o programa anterior, será gerada a seguinte 
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mom 


mensagem no Visual Studio em português: O nome "_" não existe 


no contexto atual. 


Conforme você pôde observar ao longo das seções anteriores, o 
uso de tuplas simplifica muito o nosso trabalho. A grande questão 
para muitos é saber quando devemos criar uma classe e quando 
devemos trabalhar com uma tupla. Tenha em mente que, onde a 
criação de uma classe não faz muito sentido, a tupla provavelmente 
poderá ser usada. São cenários em que estamos lidando com 
valores não relacionados, nos quais o conteúdo agrupado é o que 
realmente importa. 


Tuplas são um assunto vasto que facilmente ocuparia uma 
obra inteira. Neste capítulo, vimos um pouco do que é 
possível fazer com elas, do ponto de vista do aumento de 
produtividade do desenvolvedor. Para saber mais sobre o 
suporte a tuplas oferecido pelo C& 7.0 e posterior, acesse os 
seguintes artigos da documentação oficial: 


https://docs.microsoft.com/pt-br/dotnet/csharp/tuples 


https://docs.microsoft.com/pt-br/dotnet/csharp/whats- 
new/csharp-7átuples 


Para os casos em que é necessário escolher entre o uso de uma 
tupla e um tipo anônimo, recomendamos a leitura do 
seguinte artigo: 


https://docs.microsoft.com/pt-br/dotnet/standard/base- 


types/choosing-between-anonymous-and-tuple 
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CarírtuLo 6 


GENERICS 


Generics é um recurso extremamente produtivo para a escrita 
de código, uma vez que evita retrabalho e maximiza o desempenho 
enquanto mantém a segurança de tipo. Incluído na versão 2.0 do 
framework .NET, generics nos permite postergar a especificação 
do tipo de dado dos elementos para o momento em que ele é usado 
no código, em vez de informá-lo na etapa de design do tipo, ou 
seja, é o código de chamada que decide o tipo ao instanciar uma 
classe genérica. Em termos práticos, isso significa que o código é 
montado de modo a não precisar se preocupar com o tipo, o que 
torna possível que a classe ou método que utiliza generics trabalhe 
com qualquer tipo de dado. 


Apesar de passar despercebido para muitos desenvolvedores e 
desenvolvedoras e de assustar iniciantes, nós utilizamos generics 
com frequência em nosso dia a dia quando trabalhamos com listas, 
dicionários, LINQ e outros recursos mais avançados da linguagem. 
Por exemplo, ao criarmos uma lista de strings usando List<T> 
onde T é substituído por string , estamos usando generics para 
especificar o tipo. O parâmetro T é usado em generics para 
indicar que algo usa um parâmetro de tipo genérico. Esses 
parâmetros indicam os tipos que desejamos usar dentro de uma 
classe genérica. 
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Neste capítulo, veremos como explorar generics na construção 
de nossas próprias classes e métodos e como limitar os tipos que 
podem ser construídos a partir de um tipo genérico usando 
constraints tanto em tipos quanto em métodos. Em seguida, 
abordaremos como trabalhar com interfaces genéricas e não 
genéricas na definição de classes e coleções genéricas. O emprego 
de interfaces genéricas em nosso código ajuda a evitar ocorrências 
de operações de conversão boxing e unboxing em tipos de valor. 


O capítulo termina abordando a disponibilidade de um grande 
número de classes e interfaces genéricas no próprio framework 
prontas para uso, para evitar que você perca tempo “reinventando 
a roda”. 


6.1 CRIANDO TIPOS GENÉRICOS 


Para entender como o generics funciona na prática, vamos 
partir do exemplo a seguir: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
public class ClasseGenerica<T> 
{ 
private T _value; 
public ClasseGenerica(T value) 
{ 
_value = value; 
3 
public void IdentificarTipoDado() 
{ 
Console.writeLine($"Tipo fornecido -> T: {_value.GetT 
ype()}"); 
3 
3 
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public class Livro 


{ 
public string Titulo { get; set; } 
public string Autor { get; set; } 


public class Program 


f 


static void Main(string[] args) 


{ 


ClasseGenerica<int> varInt = new ClasseGenerica<int>( 
18); 
varInt.IdentificarTipoDado(); 


ClasseGenerica<string> varString = new ClasseGenerica 
<string>("Produtividade em C&"); 
varString. IdentificarTipoDado(); 


Livro livro = new Livro() { Titulo="Produtividade em 
cg", Autor="Claudio Ralha" 3; 

ClasseGenerica<Livro> varLivro = new ClasseGenerica<L 
ivro>(livro); 

varLivro. IdentificarTipoDado(); 


Observe que nesse exemplo definimos uma classe genérica que 
recebe como parâmetro em seu construtor o tipo de dado a ser 
utilizado. Isso é informado com o parâmetro de tipo genérico <T> . 
Esse parâmetro é um placeholder (em inglês, espaço reservado) para 
o tipo específico que o desenvolvedor vai fornecer quando a classe 
for instanciada. É preciso obrigatoriamente fornecer esse 
argumento de tipo dentro dos parênteses angulares quando 
instanciamos a classe. Veja: 

ClasseGenerica<int> varInt = new ClasseGenerica<int>(18); 


ClasseGenerica<string> varString = new ClasseGenerica<string>("Pr 
odutividade em C&"); 
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ClasseGenerica<Livro> varLivro = new ClasseGenerica<Livro>(livro) 


r4 


O segundo detalhe a ser notado é que utilizamos uma variável 
privada do tipo do parâmetro genérico T que vai armazenar o 
valor passado para a classe genérica: 


private T _value; 
Esta variável é populada no construtor da classe: 
public ClasseGenerica(T value) 


{ 


“value = value; 


No método IdentificarTipoDado , utilizamos o método 
GetType presente em todos os tipos criados em .NET e .NET 
Core para obter o tipo passado no parâmetro genérico <T> . 


Confira a seguir, a saída gerada pelo exemplo anterior: 





À CAWINDOWSisystem32Acmd.exe — o x 


Tipo fornecido -> T: System. Int32 ^ 
Tipo fornecido -> T: System.String 

Tipo fornecido -> T: ProdutividadeEmCsharp. Livro 

Pressione qualquer tecla para continuar. . . m 








Figura 6.1: Definindo uma classe com um parâmetro genérico 


Tenha em mente que o parâmetro genérico que vimos no 
exemplo anterior é nomeado por convenção como <T> , mas pode 
ter o nome que você desejar e é possível inclusive passar mais de 
um parâmetro para a classe. O código da próxima listagem ilustra 
esse cenário: 


using System; 
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namespace ProdutividadeEmCSharp 


{ 


public class ClasseGenerica<T1,T2> 


{ 


private Ti _value1; 
private T2 _value2; 


public ClasseGenerica(T1 value1, T2 value2) 


{ 
_value1 = valuel; 
_value2 = value2; 
} 
public void IdentificarTipoDado() 
{ 


Console.wWriteLine($"Tipos fornecidos -> T1: {_value1. 
GetType()} T2: {_value2.GetType()}"); 
3 


public class Program 
{ 
static void Main(string[] args) 
{ 
ClasseGenerica<int,string> teste = new ClasseGenerica 
<int, string>(2020, "Feliz ano novo!"); 
teste. IdentificarTipoDado(); 





} 
J 
} 
Ao ser executado, esse segundo exemplo produzirá a seguinte 
saída: 
CAWINDOWS\system32\cmd.exe — o x 
Tipos fornecidos -> Tl: System.Int32 T2: System.String ^ 


Pressione qualquer tecla para continuar. . 








Figura 6.2: Definindo uma classe com dois parâmetros genéricos 
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62 UTILIZANDO CONSTRAINTS EM TIPOS 
GENÉRICOS 


Apesar de toda a flexibilidade vista na seção anterior, haverá 
cenários em que não desejaremos que se possa criar qualquer tipo 
a partir de um tipo genérico que tenhamos codificado. 


Restrições (em inglês, constraints) são especificadas usando a 
palavra-chave contextual where . Elas são necessárias, pois 
informam o compilador C# das funcionalidades que um 
argumento de tipo deve ter. Quando não temos nenhuma 
restrição, o argumento de tipo pode ser qualquer tipo. Apesar de 
soar como algo bom, isso obriga o compilador a assumir somente 
os membros de object para o tipo, que é a classe base definitiva 
para qualquer tipo .NET. 


Em outras palavras, ao restringir o parâmetro de tipo, aumenta- 
se a quantidade de operações e chamadas de método permitidas 
àqueles com suporte do tipo de restrição e de todos os tipos de sua 
hierarquia de herança. 


A tabela a seguir, extraída da documentação oficial, lista os sete 
tipos de restrições atualmente suportados pelos generics: 


Restrição Descrição 
where T : O argumento de tipo deve ser um tipo de valor. Qualquer valor de 
struct tipo com exceção de Nullable<T> pode ser especificado. 
where T : O argumento de tipo deve ser um tipo de referência. Essa restrição se 
class aplica também a qualquer classe, interface, delegado ou tipo de matriz. 


O argumento de tipo não deve ser um tipo de referência e não deve 
where T : conter nenhum membro de tipo de referência em nenhum nível de 
unmanaged aninhamento. 


O argumento de tipo deve ter um construtor público sem parâmetros. 
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where T : Quando usado em conjunto com outras restrições, a restrição 


new() new() deve ser a última a ser especificada. 

where T : 
none ag O argumento de tipo deve ser ou derivar da classe base especificada. 
base> 

where T : O argumento de tipo deve ser ou implementar a interface especificada. 
<nome da Várias restrições de interface podem ser especificadas. A interface de 
interface> restrição também pode ser genérica. 

where T : O argumento de tipo fornecido para T deve ser ou derivar do 
U argumento fornecido para U . 


O código do próximo exemplo ilustra como implementar uma 
restrição de tipo T : <nome de classe base>: 


using System; 


namespace ProdutividadeEmCSharp 


É public class Pessoa 
{ 
public string Nome { get; set; } 
public DateTime DataNascimento { get; set; } 
3 
public class PessoaFisica: Pessoa 
{ 
public char Sexo { get; set; } 
public string CPF { get; set; } 
3 
public class PessoaJuridica : Pessoa 
{ 
public string CNPJ { get; set; } 
3 


public class ClasseGenerica<T> where T:Pessoa 


{ 


private T _value; 


public ClasseGenerica(T value) 


{ 
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“value = value; 
3 
public void InformarResumo() 
{ 
switch (_value) 
{ 
case PessoaFisica pf: 
string artigo = pf.Sexo == 'M' ? "O" : "A"; 
Console.WriteLine($"{artigo} cliente (pf.Nome 
} possui o CPF {pf.CPF} e nasceu em {pf.DataNascimento.ToShortDat 
eString()}."); 
break; 
case PessoaJuridica pj: 
Console.WriteLine($"A empresa {pj.Nome} possu 
i o CNPJ {pj.CNPJ} e foi fundada em {pj.DataNascimento.ToShortDat 
eString()}."); 
break; 


public class Program 

{ 
static void Main(string[] args) 
{ 

PessoaFisica pessoa = new PessoaFisica() { Nome = "cl 
audio Ralha", Sexo = 'M', CPF = "123.456.789-10", DataNascimento 
= new DateTime(1973,4,19) 3; 

ClasseGenerica<PessoaFisica> varPF = new ClasseGeneri 
ca<PessoaFisica>(pessoa); 

varPF. InformarResumo(); 

PessoaJuridica empresa = new PessoaJuridica() { Nome 
= "Ralha Teletransporte Express", CNPJ = "01.234.567/0001-89", Da 
taNascimento = new DateTime(2003, 4, 23) }; 

ClasseGenerica<PessoaJuridica> varPJ = new ClasseGene 
rica<PessoaJuridica>(empresa); 

varPJ. InformarResumo(); 


Ao observar este código, note que implementamos a restrição 
de que só é possível aceitar argumento da classe Pessoa ou 
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classes derivadas desta, como PessoaFisica e 
PessoaJuridica . Veja também que empregamos no método 
InformarResumo o recurso de correspondência de padrão de tipo 

na instrução switch introduzido no C& 7. 


O exemplo anterior produzirá a seguinte saída: 





E CAWINDOWSisystem32Acmd.exe — [ni] x 


O cliente Claudio Ralha possui o CPF 123.456.789-10 e nasceu em 19/04/19 
Ê empresa Ralha Teletransporte Express Pesi o CNPJ 01.234.567/0001-89 Ê roi fundada em 23/04/2003. 
ressione qualquer tecla para continuar. . 











Figura 6.3: Implementando uma restrição de tipo de classe base 


Caso o código de cliente tente criar uma instância da classe 
usando um tipo não permitido por uma restrição, o resultado será 
um erro em tempo de compilação. Para conferir isso na prática, 
altere o programa anterior incluindo a classe Livro : 


public class Livro 


{ 
public string Titulo { get; set; } 
public string Autor { get; set; } 


Em seguida, tente usá-la no método Main para criar uma 
instância da classe genérica: 
Livro livro = new Livro() { Titulo = "Produtividade em C&", Autor 
= "Cláudio Ralha" 3; 
ClasseGenerica<Livro> varLivro = new ClasseGenerica<Livro>(livro) 


r 


varLivro. InformarResumo(); 


Você obterá a seguinte sinalização de erro: 
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static void Main(string[] ) 
{ 


//Isto não compila 

Livro livro = new Livro() ( Titulo = “Produtividade em C&”, Autor = “Cláudio Ralha” 3; 
ClasseGenerica<Livrop varLivro = new ClasseGenerica<Livro>(livro); 

varLivro. InformarR * cass ProdutividadeEmCSharp.tivro 


O tipo "ProdutividadeEmCSharp.Livro" não pode ser usado como parâmetro de tipo "T" no tipo ou método genérico 
“ClasseGenerica<T>". Não há conversão de referência implícita de “ProdutividadeEmCSharp.Livro* em 
ProdutividadeEmCSharp Pessoa" 


Figura 6.4: Gerando um erro decorrente da restrição de tipo de classe base 


Ao utilizar constraints em generics saiba que você pode 
combinar múltiplas restrições na definição de uma única classe 
genérica. O fragmento de código a seguir, extraído da 
documentação oficial, ilustra este cenário: 
class EmployeeList<T> where T : Employee, IEmployee, System.IComp 


arable<T>, new() 


{ 
ZE aus 


Perceba como constraints em generics são um recurso 
poderoso que aumenta a segurança do código, evitando, dentre 
outras coisas, que novas pessoas de uma equipe de 
desenvolvimento utilizem uma determinada classe genérica para 
finalidades para as quais não foi planejada. 


Apesar de os generics estarem presentes desde o Cf 2.0, este é 
um modelo de programação que está em constante 
desenvolvimento. No Cf 7.3, as restrições nos parâmetros de tipos 
passaram a suportar restrições não gerenciadas (voltada para tipos 
não gerenciados), restrições de delegados e restrições de 
enumerados. 
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6.3 UTILIZANDO CONSTRAINTS EM 
MÉTODOS GENÉRICOS 


As constraints de parâmetros de tipos genéricos que utilizamos 
previamente em nível de tipo, podem ser aplicadas também em 
métodos genéricos. O exemplo a seguir ilustra este cenário: 


using System; 
using System.Collections.Generic; 


namespace ProdutividadeEmCSharp 


{ 
public class ClasseGenerica<T> where T: class 
{ 
public string Concatenar<U>(List<U> items) where U : stru 
ct 
{ 
string resultado = string.Empty; 
bool primeiro = true; 
foreach (var item in items) 
{ 
if (primeiro == false) 
{ 
resultado += ","; 
3 
else 
{ 
primeiro = false; 
3 
resultado += item.ToString(); 
3 
return resultado; 
3 
3 
public class Program 
{ 
static void Main(string[] args) 
{ 
string saida = String.Empty; 
List<int> inteiros = new List<int>(){0,1,2,3,4,5,6,7, 
8,9}; 
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List<char> vogais = new List<char>() {'a','e','i','o' 
4 'u'}; 

List<string> estacoes = new List<string>() {"Primaver 
a", "verão", "Outono", "Inverno"}; 

ClasseGenerica<string> classe = new ClasseGenerica<st 
ring>(); 

saida = classe.Concatenar<int>(inteiros); 

Console.wWriteLine($"inteiros: (saida)"); 

saida = classe.Concatenar<char>(vogais); 

Console.writeLine($"vogais: (saida)"); 

//Isso não compila 

//saida = classe.Concatenar<string>(estacoes); 

//Console.writeLine($"estacoes: (saida)"); 


Note que aplicamos uma restrição de parâmetro de tipo <T> 
na classe genérica indicando que ela só pode receber como 
argumento um tipo de referência (ou seja, uma classe que neste 
exemplo não usamos para nada) e aplicamos uma restrição 
semelhante no método Concatenar indicando que ele só pode 
receber uma lista List<U>, na qual o parâmetro de tipo uU 
obrigatoriamente precisa ser um tipo de valor (uma estrutura). Ao 
executarmos esse exemplo com o trecho de código final do método 
Main comentado, obteremos a saída a seguir: 





ER CAWINDOWSisystem32Acmd.exe — o XxX 


inteiros: 0,1,2,3,4,5,6,7,8,9 A 
vogais: a,e,i,o,u s 
Pressione qualquer tecla para continuar. . . m 











Figura 6.5: Implementando uma restrição de parâmetro de tipo em um método genérico 


Ao descomentarmos o trecho final, veremos que o editor de 
código do Visual Studio sinalizará que não é possível utilizar o tipo 
string como parâmetro para o método Concatenar , por ele ser 
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um tipo de referência e não um tipo de valor. Veja: 


//Isto não compila 


saida = classe.Concatenarsstring>(estacoes); 


Console.WriteLine($"estaco * cass System.Sting 


Represents text as a sequence of UTF-16 code units. 


O tipo "string" deve ser um tipo de valor não nulo para que seja usado como parâmetro "U" no tipo ou método genérico 
"ClasseGenerica<string> Concatenar<U> (List<U>)" 


Figura 6.6: Gerando um erro decorrente da restrição de tipo no parâmetro de método 


Isso nos permite limitar os tipos com os quais desejamos 
trabalhar no método com um mínimo de esforço. 


Vale destacar que é possível definir um método genérico em 
uma classe não marcada como genérica. Na próxima seção, 
ilustraremos um exemplo que demonstra esse cenário. 


6.4 DRIBLANDO LIMITAÇÕES DE CÁLCULOS 
EM MÉTODOS GENÉRICOS 


Efetuar cálculos em tipos genéricos não é uma tarefa tão 
simples como pode parecer em um primeiro momento. Para 
entendermos por que isso ocorre, vamos partir do exemplo a 
seguir, que não é compilável: 


using System; 


namespace ProdutividadeEmCSharp 


f public class Calculadora 
f public T Adicionar<T>(T a, T b) 
{ 
return a + b; 
3 
3 
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public class Program 


f 


static void Main(string[] args) 
{ 
Calculadora calc = new Calculadora(); 
int a = 5, b = 10; 
double c = 6.50, d = 8.12; 
string e = "Produtividade", f =" em C#"; 
var resultado1 = calc.Adicionar(a, b); 
Console.WwriteLine($"{a} + {b} = {resultado1} ({result 
ado1.GetType()})"); 
var resultado2 = calc.Adicionar(c, d); 
Console.WwriteLine($"{c} + {d} = {resultado2} ({result 
ado2.GetType()})"); 
var resultado3 = calc.Adicionar(e, f); 
Console.WwriteLine($"{e} + {f} = {resultado3} ({result 
ado3.GetType()})"); 


} 
} 


Ao parar o mouse sobre a linha que contém a soma de a e b 
no método genérico Adicionar da classe Calculadora , você 
verá o aviso de erro informando que não é possível aplicar o 
operador + aos operandos do tipo T . Isso ocorre porque os 
generics são implementados em C# em tempo de execução e são 
verificados em tempo de compilação. Como não definimos 
qualquer restrição para o parâmetro de tipo, ele será do tipo 
System.Object. 


Infelizmente, a classe base Object não define uma operação 
de adição, pois nem todos os objetos suportam esta operação. 
Como T pode ser qualquer tipo em tempo de execução, o 
compilador não pode determinar o significado de a + b , pois os 
tiposde a ede b ainda não foram determinados. 


A primeira solução que nos vem à cabeça ao enfrentarmos este 
dilema é restringir os parâmetros de tipo definindo uma interface 
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que o tipo deverá implementar. Essa abordagem, todavia, não vai 
funcionar, pois as interfaces não podem conter métodos estáticos e 
os métodos de operador precisam ser estáticos. 


Conforme explicado no artigo de Rudiger Klaehn, publicado 
no site Code Project, com o sistema de restrições corrente, não 


é possível definir constraints para operadores: 


https://www.codeproject.com/ Articles/8531/Using-generics- 
for-calculations 





Para tornar esse código compilável, é preciso recorrer ao tipo 
estático dynamic introduzido no C& 4.0. Veja: 


public class Calculadora 


{ 
public T Adicionar<T>(T a, T b) 
{ 8 
return i(dynamic)ia + b; 
} epa é | 
} 


Figura 6.7: Convertendo o resultado da soma para dynamic 


O tipo dynamic criará uma árvore de expressão que será 
resolvida em tempo de execução. Confira a saída produzida pelo 
exemplo anterior ao ser executado: 
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fe] CAWINDOWS\system32\cmd.exe — xX 


5 + 10 = 15 (System. Int32) A 
6,5 + 8,12 = 14,62 (System.Double) 

Produtividade + em C# = Produtividade em C# (System.String) 

Pressione qualquer tecla para continuar. . . m 




















Figura 6.8: Efetuando somas com diferentes tipos de dados 


Perceba que para contornar o problema foi necessário abrir 
mão da verificação de tipo em tempo de compilação usando 
dynamic . Esta abordagem tem um custo em termos de segurança 
e desempenho que precisa ser considerado. 


Para saber mais sobre a criação de tipos genéricos em Cf e 
sobre a definição de restrições nos parâmetros de tipos, acesse 
as seguintes páginas da documentação oficial: 


https://docs.microsoft.com/pt- 
br/dotnet/csharp/programming-guide/generics/ 


https://docs.microsoft.com/pt- 


br/dotnet/csharp/programming-guide/generics/constraints- 
on-type-parameters 





6.5 CRIANDO INTERFACES GENÉRICAS 


A criação de interfaces genéricas em C& é muito semelhante à 
criação de uma classe genérica. As interfaces genéricas são 
definidas para classes de coleção genéricas ou para as classes 
genéricas que representam itens na coleção. 


Veja a seguir um exemplo no qual temos uma classe genérica 
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Calculadora<T> que implementa uma interface genérica 
ICalculadora<T> : 


using System; 


namespace ProdutividadeEmCSharp 


f public interface ICalculadora<T> 
{ 
T Adicionar(T a, T b); 
T Subtrair(T a, T b); 
T Multiplicar(T a, T b); 
T Dividir(T a, T b); 
3 
public class Calculadora <T> : ICalculadora<T> 
É public T Adicionar(T a, T b) 
{ 
return (dynamic) a + b; 
3 
public T Subtrair(T a, T b) 
{ 
return (dynamic) a - b; 
3 
public T Dividir(T a, T b) 
{ 
return (dynamic) a / b; 
3 
public T Multiplicar(T a, T b) 
{ 
return (dynamic) a * b; 
3 
3 


public class Program 


{ 


static void Main(string[] args) 


{ 
Calculadora<int> calc = new Calculadora<int>(); 
int a = 10, b = 5; 
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Console.WriteLine($"(a) + {b} {calc.Adicionar(a, b) 


39); 

Console.writeLine($"(a) - {b} = (calc.Subtrair(a, b)} 
Di 

Console.wWriteLine($"(a) * {b} = (calc.Multiplicar(a, 
b)}"); 

Console.writeLine($"(a) / {b} = (calc.Dividir(a, b)}" 
); 

} 
} 

} 


Ao ser executado, esse exemplo vai produzir a seguinte saída: 





E CAWINDOWS\system32\cmd.exe — o XxX 
10 + 5 = 15 A 
DO -5=5 

20 * 5 = 50 

Os = 


Pressione qualquer tecla para continuar. .. 








Figura 6.9: Criando uma classe que herda de uma interface genérica 


Note que também é possível usar constraints na definição de 
uma interface. Poderíamos alterar o código da interface 
ICalculadora , do exemplo anterior, como a seguir: 


public interface ICalculadora<T> where T : struct 


{ 
T Adicionar(T a, T b); 
T Subtrair(T a, T b); 
T Multiplicar(T a, T b); 
T Dividir(T a, T b); 

3 


Para que o código continue compilável, será necessário aplicar 
a restrição também à classe Calculadora<T>. Veja: 


public class Calculadora<T> : ICalculadora<T> where T: struct 


{ 
public T Adicionar(T a, T b) 


{ 
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return (dynamic) a + b; 


3 
public T Subtrair(T a, T b) 
{ 

return (dynamic) a - b; 
3 
public T Dividir(T a, T b) 
{ 

return (dynamic) a / b; 
3 
public T Multiplicar(T a, T b) 
{ 

return (dynamic) a * b; 
3 


Cabe ressaltar que, se uma ou mais interfaces (genéricas ou não 
genéricas) forem especificadas como restrições em um parâmetro 
de tipo, somente os tipos que implementarem as interfaces 
enumeradas poderão ser usados. O exemplo a seguir ilustra este 
segundo cenário: 


using System; 
using System.Collections.Generic; 


namespace ProdutividadeEmCSharp 


{ 
public interface IObra 
{ 
string Codigo { get; set; } 
string Titulo { get; set; } 
string Autores { get; set; } 
3 


public class Livro : IObra 

{ 
public string Codigo { get; set; } 
public string Titulo { get; set; } 
public string Autores { get; set; } 
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public string Resumo ( get; set; } 


public class Quadro : IObra 


{ 
public string Codigo { get; set; } 
public string Titulo { get; set; } 
public string Autores { get; set; } 
3 


public class Musica 


{ 
public string Titulo { get; set; } 
public string Autores { get; set; } 
public string Letra { get; set; } 

3 


public class Lista0Obras<T> where T : class, IObra, new() 


£ 


List<T> itens; 


public Lista0bras() 


{ 
itens = new List<T>(); 
3 
public void Adicionar(T item) 
{ 
itens.Add(item); 
3 


public void Listar() 
{ 


foreach (T item in itens) 


{ 
Console.writeLine($"Código: {item.Codigo}  Títul 


o: {item.Titulo} Autores: {item.Autores}"); 
3; 
3 
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public class Program 


{ 
static void Main(string[] args) 
{ 
Lista0bras<Livro> livros = new Lista0bras<Livro>(); 
livros.Adicionar(new Livro() { Codigo = "121", Titulo 
= "Segredos do Visual Studio.NET", Autores = "Cláudio Ralha" }); 
livros.Adicionar(new Livro() { Codigo = "122", Titulo 


"Produtividade em C#", Autores = "Cláudio Ralha" }); 
Console.writeLine("Listando livros:\n"); 
livros.Listar(); 

ListaObras<Quadro> quadros = new ListaObras<Quadro>() 


quadros.Adicionar (new Quadro() { Codigo = "201", Titu 
lo = "O Girassol", Autores = "Iara Ralha" 3); 

quadros.Adicionar (new Quadro() { Codigo = "202", Titu 
lo = "A menina no balanço", Autores = "Iara Ralha e Cláudio Ralha 
"p; 


Console.writeLine("\nListando quadros:\n"); 
quadros.Listar(); 

//Isto não compila 

//ListaObras<Musica> musicas = new ListaObras<Musica> 


O; 


Observe que a classe Listaobras<T> foi definida assim: 


public class Lista0Obras<T> where T : class, IObra, new(){ 


Isso significa que só serão aceitos os tipos que forem classes, 
que implementem a interface Iobra e que possuam um 
construtor default. Observe no final do método main que existe 
uma linha de código comentada. Esta linha contém um erro que 
demonstra a restrição imposta pela interface. 


Ao executarmos este exemplo com a linha comentada, 
obteremos a seguinte saída: 
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EM CAWINDOWSisystem32icmd.exe E x 
Listando livros: A 











ódigo: 121 Título: Segredos do Visual Studio.NET Autores: Cláudio Ralha 
codigo: 122 Titulo: Guia de Validação de dados em C# Autores: Cláudio Ralha 
ódigo: 123 Título: Produtividade em C# Autores: Cláudio Ralha 


Listando quadros: 


ódigo: 201 Título: O Girassol Autores: Iara Ralha 

codigo: 202 Titulo: A menina no balanço Autores: Iara Ralha e Cláudio Ralha 
ódigo: 203 Título: O peixe palhaço Autores: Iara Ralha 

Pressione qualquer tecla para continuar. 











Figura 6.10: Utilizando uma interface em uma constraint de parâmetro de tipo 


Descomente a linha comentada e veja que o código não é mais 
compilável. Isso ocorre porque a classe Musica não implementa a 
interface IObra . 


6.6 UTILIZANDO TIPOS GENÉRICOS 
EXISTENTES NO FRAMEWORK 


Nas seções anteriores, vimos um pouco da mecânica por trás 
da criação de tipos genéricos. Como se trata de um recurso de 
aplicação geral que evita retrabalho e maximiza o desempenho e a 
segurança de tipo, os próprios frameworks .NET e .NET Core já 
dispõem de um grande número de classes, estruturas e interfaces 
pré-construídas e testadas para tratar de classes e coleções 
genéricas nos namespaces System.Collections.Generic e 

System.Collections.0bjectModel . Estão disponíveis: 

List<T> , Collection<T> , ReadOnlyCollection<T> , 

IEnumerable<T> , IEnumerator<T> , IList<T> , 
ICollection<T> , LinkedList<T> , Queue<T> , Stack<T> , 
SortedList<TKey, Tvalue> , Dictionary<TKey, TValue> , 
SortedDictionary<TKey, TValue> , dentre outras. 
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Uma abordagem detalhada sobre cada um desses tipos foge ao 
escopo deste livro, mas você poderá obter exemplos de uso 
sobre os tipos desejados, usando como ponto de partida as 
seguintes páginas da documentação oficial: 


https://docs.microsoft.com/pt- 
br/dotnet/standard/generics/collections 


https://docs.microsoft.com/pt- 
br/dotnet/standard/collections/commonly-used-collection- 


types 


https://docs.microsoft.com/pt- 
br/dotnet/standard/generics/interfaces 


Reserve um tempo para aprofundar os seus conhecimentos 
em generics, pois esta é uma funcionalidade que vai lhe 
poupar horas de trabalho e muitas dores de cabeça. Para 
entender os tipos de problemas que os generics são capazes de 
resolver, recomendamos a leitura do seguinte artigo do 
mestre Macoratti, que também assina o prefácio deste livro: 


https://imasters.com.br/back-end/c-3-motivos-importantes- 
para-usar-generics 





Ainda que não seja possível condensar um assunto tão vasto 
em poucas páginas sem abrir mão de alguns detalhes, esperamos 
que você tenha percebido o quanto generics pode ser reutilizável e 
o quanto de trabalho ele é capaz de poupar. Lembre-se de que você 
poderá utilizá-lo para ir além de apenas criar classes, interfaces e 
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métodos genéricos, implementando coleções, estruturas e 
delegados genéricos. Trata-se de um recurso poderoso, elegante e 
simples de usar que precisa fazer parte do dia a dia do 
desenvolvedor e da desenvolvedora profissional. 


6.6 UTILIZANDO TIPOS GENÉRICOS EXISTENTES NO FRAMEWORK 179 


CAPÍTULO 7 


LINQ 


O LINQ (acrônimo de Language Integrated Query) é um 
modelo de manipulação de dados incluído originalmente no 
framework .NET 3.0 que foi projetado para fornecer aos 
programas a habilidade de selecionar dados da mesma forma como 
qualquer fonte de dados que implemente uma das seguintes 
interfaces: IEnumerable , IEnumerable<T> ou 

IQueryable<T> . Em termos práticos, isso significa que a partir de 
uma sintaxe única podemos criar expressões de consulta para 
retornar um conjunto de dados obtidos a partir de origens como 
arrays, listas, bancos de dados relacionais, documentos XML, 
planilhas do Excel, logs do Windows etc. Tudo isso sem perder a 
segurança de tipos! 


Para suportar o LINQ, os frameworks .NET e .NET Core 
empregam vários recursos das linguagens C# e Visual Basic 
relacionados à produtividade, como inferência de tipos, tipos 
anônimos, métodos de extensão, expressões lambda, literais XML, 
tipos anuláveis, inicializadores de objetos e operador ternário if. 


Os frameworks .NET e .NET Core oferecem provedores LINQ 
integrados para consulta nos seguintes tipos de dados: 


e LINQ para Objetos - Usado para consultas sobre qualquer 
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tipo de objeto do C# na memória, como matrizes, listas e 
outros tipos de coleções. 

e LINQ para XML - Usado para a criação e manipulação de 
documentos XML usando a sintaxe e mecanismo de 
consulta geral do LINQ. 

e LINQ para JSON - Usado para a criação e manipulação de 
documentos JSON. 

e LINQ para Entidades - Usado para consultas baseadas nos 
frameworks de mapeamento Objeto/Relacional Entity 
Framework e Entity Framework Core. 

e LINQ para SQL - Usado para consultas a bancos de dados 
como alternativa ao LINQ para Entidades. 

e LINQ para Data Set - Usado para consultas a bancos de 
dados baseadas no objeto DataSet , disponível desde a 
primeira versão do Framework .NET (apenas para sistemas 
legados). 

e LINQ Paralelo - Estende o LINQ a Objetos com uma 
biblioteca de programação paralela que permite dividir 
uma consulta de modo que ela seja executada 
simultaneamente em múltiplos núcleos de um processador 
multicore. 


Nas próximas páginas, apresentaremos como usar o LINQ para 
retornar um ou mais resultados (distintos ou não), demonstrando 
como efetuar filtragem, junções, uniões de duas fontes de dados e 
ordenação dos resultados. Focaremos apenas no LINQ para 
Objetos pela facilidade de construção de exemplos curtos que 
incluem as fontes de dados embutidas, mas tenha em mente que a 
sintaxe a ser empregada nos demais provedores LINQ é a mesma 
ou pelo menos similar. 
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Você verá que para realizar operações sobre as fontes de dados 
pode-se utilizar dois tipos de sintaxe: consulta (query) e método 
(também chamada de high order functions ou HOF). Ambas as 
alternativas são bastante produtivas, sendo a sintaxe de consulta 
mais legível e a sintaxe HOF, mais concisa. 


Escolher entre uma sintaxe e outra é uma questão de 
preferência pessoal. Utilize a opção com a qual se sentir mais 
confortável ou então tire proveito de ambas, aplicando a opção 
mais adequada em cada caso. Ao longo da maior parte deste 
capítulo, trabalharemos com a sintaxe de consulta, por ser mais 
intuitiva e familiar a desenvolvedores com experiência prévia em 
linguagem SQL. 


7.1 FILTRANDO DADOS USANDO LINQ 


Para entender como as consultas LINQ funcionam, partiremos 
do exemplo a seguir onde utilizamos LINQ para efetuar uma 
consulta a uma fonte de dados representada por uma lista genérica 
de strings que retornará todos os nomes da lista que iniciam com a 
letra 'C': 
using System; 


using System.Collections.Generic; 
using System.Ling; 


namespace ProdutividadeEmCSharp 


{ 


public class Program 


{ 


static void Main(string[] args) 


í 
List<string> nomes = new List<string>() { "Cláudio", 
"Flávia", "Iara", "Cristiane", "Renan", "Yidal", "Lígia", "Ana", 
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"Branca", "Ceres", "Camila", "Elisa", "Karen", "Marco Aurélio", " 
Francisco”, "Carlos", "Lucas", "Ricardo", "Cláudia", "Michel", "G 
ustavo", "Rafael" 3; 
var resultado = from n in nomes 
where n.StartsWith("C") 
select n; 
Console.wWriteLine("Nomes que começam com a letra C:\n 
); 
foreach (var item in resultado) 


{ 


Console.writeLine(item); 


Observe que a consulta que criamos usa uma sintaxe muito 
intuitiva e parecida com a adotada na linguagem SQL, voltada para 
bancos de dados relacionais. A mudança mais significativa é a 
ordem das cláusulas, que no LINQ difere iniciando pelo from em 
vez de select . Veja: 
var resultado = from n in nomes 

where n.StartsWith("Cc") 
select n; 

Confira na próxima imagem o resultado produzido por esse 

exemplo: 





EM CNWINDOWSisystem32Acmd.exe = m| x 
Nomes que começam com a letra C: A 


ristiane 
eres 
Camila 

ar los 
Cláudia 


ressione qualquer tecla para continuar. 


Er áudio 








Figura 7.1: Filtrando a lista por nomes que iniciam com a letra C 
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Efetuar mudanças em uma consulta LINQ é uma tarefa 
simples, na maior parte dos casos. Para também incluir na consulta 
anterior nomes que começam com a letra 'K' (que possui em 
português som próximo ao da letra 'C'), basta alterá-la como 
mostrado a seguir: 
var resultado = from n in nomes 


where n.StartsWith("C") || n.StartsWith("KkK") 
select n; 


Para complicarmos um pouco, na próxima consulta desejamos 
obter a lista de nomes que iniciam com 'C' ou 'K' e possuem mais 
de 6 caracteres: 
var resultado = from n in nomes 

where (n.StartsWith("C") || n.StartsWith("K'")) && 


n.Length > 6 
select n; 


Observe que nesse caso usamos parênteses para garantir que os 
filtros sejam implementados como desejado e para aumentar a 


legibilidade. 


O próximo exemplo ilustra como usar o operador Contains 
para executar uma busca case-insensitive em uma lista de nomes e 
retornar todos os elementos que contêm ana : 

List<string> nomes = new List<string>() { "Flávia", "Ana Paula", 
"Ana Cristina", "Ana Tereza", "Iara", "Cristiane", "Renata", "Júl 
ia", "Luciana", "Juliana", "Giovanna" 3; 
var resultado = from n in nomes 

where n.Contains("ana", StringComparison.OrdinalI 


gnorecase) 
select n; 


O operador Contains é usado para checar se um elemento 
está contido em uma coleção ou não. 
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No exemplo a seguir, combinamos LINQ para Objetos com 
expressões regulares para obter a lista de nomes que possuem 
caracteres acentuados. Veja: 
using System; 
using System.Collections.Generic; 


using System.Ling; 
using System.Text.RegularExpressions; 


namespace ProdutividadeEmCSharp 


{ 
public class Program 
{ 
static void Main(string[] args) 
{ 
string padrao = @"[^a-zA-Z]"; 
Regex regex = new Regex(padrao); 
List<string> nomes = new List<string>() { "Cláudio", 
"Flávia", "Iara", "Cristiane", "Renan", "Vidal", "Lígia", "Ana", 
"Branca", "Ceres", "Camila", "Elisa", "Karen", "Marco Aurélio", " 
Francisco", "Carlos", "Lucas", "Ricardo", "Cláudia", "Michel", "G 
ustavo", "Rafael" 3; 
var resultado = from n in nomes 
where regex. IsMatch(n) 
select n; 
Console.writeLine("Nomes que possuem caracteres acent 
uados:"); 
foreach (var item in resultado) 
{ 
Console.writeLine(item); 
} 
} 
} 
} 


Na próxima imagem, temos a saída gerada por esse código: 
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ER CNWINDOWSisystem32Acmd.exe — o x 
Nomes que possuem caracteres acentuados: A 


Táudio 

Flávia 

Ligia ER 

arco Aurélio 

láudia 

Pressione qualquer tecla para continuar. . . 











Figura 7.2: Filtrando a lista por nomes que contêm caracteres acentuados 


O exemplo a seguir efetua uma consulta sobre uma lista de 
objetos do tipo Pessoa , retornando apenas as pessoas do sexo 
feminino: 
using System; 


using System.Collections.Generic; 
using System.Ling; 


namespace ProdutividadeEmCSharp 


{ 
public class Pessoa 
{ 
public string Nome { get; set; } 
public int Idade { get; set; } 
public char Sexo { get; set; } 
3 
public class Program 
{ 
static void Main(string[] args) 
{ 
List<Pessoa> pessoas = new List<Pessoa> 
{ 
new Pessoa() { Nome = "F1 
avia" , Idade = 38, Sexo = 'F' }, 
new Pessoa() { Nome = "C1 
áudio" , Idade = 46, Sexo = 'M' }, 
new Pessoa() { Nome = "Ia 
ra" , Idade = 2, Sexo = 'F' }, 
new Pessoa() { Nome = "Cr 
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istiane" , Idade = 43, Sexo = 'F' 3, 


new Pessoa() { Nome = "Re 
nan" , Idade = 35, Sexo = 'M' 3 
3; 
var resultado = from p in pessoas 
where p.Sexo == 'F' 
select p; 


Console.writeLine("Pessoas do sexo feminino:"); 
foreach (var item in resultado) 


{ 


Console.writeLine(item.Nome); 


Observe que, na consulta anterior, obtemos como resultado 
uma lista de objetos do tipo Pessoa . Veja: 


var resultado = from p in pessoas 
where p.Sexo == 'F' 
select p; 


Console.writeLine("Pessoas do sexo feminino:"); 
foreach (var item in resultado) 


{ 


Console.writeLine(item.Nome); 


Como só estamos usando a propriedade Nome no loop 
foreach , podemos modificar o trecho de código anterior 
conforme mostrado a seguir: 


var resultado = from p in pessoas 
where p.Sexo == 'F' 
select p.Nome; 


Console.writeLine("Pessoas do sexo feminino:"); 
foreach (var item in resultado) 


{ 


Console.writeLine(item); 


7.1 FILTRANDO DADOS USANDO LINQ 187 


Para obter apenas as pessoas do sexo feminino maiores de 
idade, bastaria incluir este critério na cláusula where conforme a 
consulta a seguir: 
var resultado = from p in pessoas 


where p.Sexo == 'F' && p. Idade >=18 
select p.Nome; 


7.2 EMPREGANDO OPERADORES DE 
ELEMENTOS COM RETORNO ÚNICO 


O LINQ fornece operadores de elementos que retornam um 
único elemento ou um elemento específico de uma coleção. São 
eles: Single , SingleorDefault , First, FirstoOrDefault , 
Last e LastOrDefault. 


Confira na lista a seguir a utilidade de cada um deles: 


e Single - Retorna um único elemento específico de uma 
coleção de elementos se o elemento bate com os critérios 
especificados. Uma exceção é lançada se nenhuma ou mais 
de uma correspondência for encontrada para esse elemento 
na coleção. 

e SingleorDefault - Retorna um único elemento 
específico de uma coleção de elementos se o elemento bate 
com os critérios especificados. Uma exceção é lançada caso 
mais de uma correspondência seja encontrada para esse 
elemento na coleção. Um valor padrão é retornado se 
nenhuma correspondência for encontrada para esse 
elemento na coleção. 


First - Retorna o primeiro elemento de uma coleção de 
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elementos que atende aos critérios especificados, se um ou 
mais objetos forem encontrados. Uma exceção é lançada 
caso nenhuma correspondência seja encontrada para esse 
elemento na coleção. 

e FirstOrDefault - Retorna o primeiro elemento de uma 
coleção de elementos que atende aos critérios especificados, 
se um ou mais objetos forem encontrados. Um valor 
padrão é retornado caso nenhuma correspondência seja 
encontrada para esse elemento na coleção. 


No caso de dúvida sobre qual deles empregar, basta lembrar do 
seguinte: 


e Se um conjunto de resultados contém mais de um 
elemento que atende aos critérios especificados e você quer 
que uma exceção seja lançada, use Single ou 
SingleorDefault. 


e Se um conjunto de resultados não contém nenhum registro 
que atenda aos critérios e você quer que um valor padrão 
seja devolvido, use FirstOrDefault . 


Na maioria dos casos, a escolha mais adequada será 

FirstorDefault , que executa mais rápido que 
SingleorDefault e não lança exceção se não encontrar nenhum 
elemento que atenda aos critérios ou se encontrar mais de um 
elemento. 


Para ilustrar o uso de FirstOrDefault , vamos alterar a 
última consulta apresentada na seção anterior. Veja: 


var resultado = (from p in pessoas 
where p.Sexo == 'F' 
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select p).FirstOrDefault(); 


Console.writeLine(resultado. Nome); 


Veja que agora usamos parênteses para isolar a consulta 
original, antes de aplicarmos FirstorDefault . 


7.3 EMPREGANDO DISTINCT PARA OBTER 
RESULTADOS ÚNICOS 


O método Distinct do LINQ é usado para retornar 
elementos distintos de uma fonte de dados. Empregá-lo sobre uma 
lista de tipos de valor ou sobre uma lista de strings é algo 
extremamente simples, conforme você pode observar nos 
exemplos a seguir: 
using System; 


using System.Collections.Generic; 
using System.Ling; 


namespace ProdutividadeEmCSharp 


{ 
public class Program 
{ 
static void Main(string[] args) 
{ 
List<int> numeros = new List<int>() 
{ 
1,2,3,4,5,6,3,4,5,2,1,6 
F; 


var resultado = (from num in numeros 
select num).Distinct(); 


foreach (var item in resultado) 


{ 


Console.writeLine(item); 


} 
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Para casos como este, recomendamos utilizar a sintaxe de 
método (leia-se sintaxe HFO) no lugar da sintaxe de consulta que 
tornará o código mais legível. Compare: 


var resultado = numeros.Distinct(); 


No próximo exemplo, demonstramos como usar um segundo 
overload do método Distinct , que recebe IEqualityComparer 
como argumento para os cenários em que precisamos fazer uma 
comparação case-insensitive. Veja: 


using System; 
using System.Ling; 


namespace ProdutividadeEmCSharp 


{ 
public class Program 
{ 
static void Main(string[] args) 
{ 
string[] habilidades = { "Flexibilidade", "Autoconfia 
nça", "Autoconhecimento", "Iniciativa", "Competitividade", "visão 
no cliente”, 
"Compreensão interpessoal", "Empatia", "Capacidad 


e de liderança", "Persuasão", "Trabalho em Equipe", "visão do neg 
ócio", "empatia", "persuasão", "INICIATIVA" 3; 

var resultado = habilidades.Distinct(StringComparer.o 
rdinalIgnorecase); 

Console.writeLine("Habilidades de um bom profissional 


An"); 
foreach (var item in resultado) 
{ 
Console.WriteLine($"* {item}"); 
3 
3 
3 
3 


7.3 EMPREGANDO DISTINCT PARA OBTER RESULTADOS ÚNICOS 191 


Até aqui tudo funciona como esperado e não há nenhum 
trabalho extra a ser feito. As coisas começam a complicar quando 
surge a necessidade de aplicarmos Distinct a uma coleção de 
tipos complexos. O exemplo a seguir parece correto, mas vai falhar 
ao tentar retornar uma lista de pessoas distintas que participarão 
de uma viagem: 
using System; 


using System.Collections.Generic; 
using System.Ling; 


namespace ProdutividadeEmCSharp 


{ 
class Pessoa 
{ 
public string Nome { get; set; } 
public int Idade { get; set; } 
public char Genero { get; set; } 
3 
public class Program 
{ 
static void Main(string[] args) 
{ 
List<Pessoa> pessoas = new List<Pessoa>() 
{ 
new Pessoa(){Nome = "Pedro", Idade = 16, Genero = 
EMU; 
new Pessoa(){Nome = "Paulo", Idade = 18, Genero = 
MF, 
new Pessoa()(Nome = "Marcela", Idade = 16, Genero 
— RIY 
new Pessoa(){Nome = "Roberta", Idade = 21, Genero 
— 'F'3, 
new Pessoa()(Nome = "Ricardo", Idade = 19, Genero 
— 'M'3 
new Pessoa()(Nome = "Sofia", Idade = 14, Genero = 
'E'}; 
new Pessoa(){Nome = "Vanessa", Idade = 22, Genero 
— 'P'3, 
new Pessoa()(Nome = "Rodrigo", Idade = 20, Genero 
— 'M'3 
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new Pessoa()(Nome = "Rebeca", Idade = 25, Genero 





— i F 1 } 
new Pessoa(){Nome = "Henrique", Idade = 13, Gener 
o — 1 M 1 } 
new Pessoa(){Nome = "Pâmela", Idade = 21, Genero 
— Li F 1 
new Pessoa()(Nome = "Alessandra", Idade = 19, Gen 
ero = 'F' 3, 
new Pessoa()(Nome = "Pedro", Idade = 16, Genero = 
1 M 1 }, 
new Pessoa(){Nome = "Vanessa", Idade = 22, Genero 
= 1 F { } 
3; 
var resultado = pessoas.Distinct(); 
Console.wWriteLine("Pessoas selecionadas para a viagem 
E a DE 
foreach (var item in resultado) 
{ 
Console.WriteLine($"* {item.Nome}"); 
3 
3 
3 
} 
Confira o resultado na imagem a seguir: 

E CAWINDOWS\system32\cmd.exe — o x 
Pessoas selecionadas para a viagem: A 
[pedro] 
=*Paulo. 

* Marcela 
* Roberta 
* Ricardo 
* Sofia. 
w Vanessa; 
* “Rodrigo” 
* Rebeca 

* Henrique 
* Pâmela 

* Alessandra 
“iPedro 1 
*1 Vanessa 1 








v 





Figura 7.3: Método Distinct falhando ao retornar itens de uma coleção de um tipo complexo 
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Isso ocorre porque o comparador default checa apenas se as 
referências dos dois objetos são iguais, sem levar em consideração 
os valores das propriedades do tipo complexo. Há quatro soluções 
principais para este problema, a saber: 


e Utilizar a versão sobrecarregada do método Distinct 
que usa a interface IEqualityComparer como 
argumento. Criar uma classe PessoaComparer que deverá 
implementar a interface IEqualityComparer (a interface 
contém os métodos Equals e GetHashCode ). Feito isso, 
podemos criar uma instância da classe PessoaComparer e 
depois passar essa instância para o método Distinct . 

e Substituir os métodos Equals e GetHashCode na classe 
Pessoa . 

e Projetar as propriedades necessárias em um novo tipo 
anônimo que, por padrão, já substitui os métodos Equals 
e GetHashCode . 

e Implementar a interface IEquatable <T>. 


Não apresentaremos aqui exemplos para as quatro 
abordagens, apenas a solução que envolve menos esforço do 
desenvolvedor, mas se desejar consultar uma comparação das 
quatro soluções, recomendamos a leitura do seguinte artigo: 


https://dotnettutorials.net/lesson/linq-distinct-method/ 





A abordagem que usaremos para resolver o problema, envolve 
a criação de um tipo anônimo. Para implementá-lo, basta 
substituir, no exemplo anterior, a linha a seguir: 
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var resultado = pessoas.Distinct(); 
Por esta: 


var resultado = pessoas.Select(p => new { p.Nome, p.Idade, p.Gene 
ro )).Distinct(); 
Execute o programa uma vez mais e veja que agora o resultado 
é o esperado. A abordagem que os desenvolvedores costumam usar 
com maior frequência é a que envolve substituir os métodos 
Equals e GetHashCode na classe Pessoa , o que resultaria no 
acréscimo de linhas de código. Perceba que a solução adotada não 
adicionou nenhuma linha extra ao código. 


7.4 EMPREGANDO UNION PARA COMBINAR 
DUAS FONTES DE DADOS 


O método Union do LINQ é usado para combinar as várias 
fontes de dados em uma fonte de dados única, removendo os 
elementos duplicados. Para ilustrar o seu uso, vamos partir de um 
exemplo que combina duas listas de tipos de valor: 
using System; 


using System.Collections.Generic; 
using System.Ling; 


namespace ProdutividadeEmCSharp 


{ 
public class Program 
{ 
static void Main(string[] args) 
{ 
List<int> listal = new List<int>() { 1, 2, 3,4,5}; 
List<int> lista2 = new List<int>() { 3, 6, 2, 4, 7,9 
J; 


var resultado = lista1.Union(lista2).ToList(); 
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foreach (var item in resultado) 


{ 


Console.writeLine(item); 


Assim como ocorre com outros operadores do LINQ, como o 
Distinct , utilizar Union com tipos complexos requer a 
implementação de uma das soluções descritas na seção anterior. 


O exemplo a seguir demonstra como usar tipos anônimos para 
combinar as duas listas ( pessoas1 e pessoas2 ) do tipo 
Pessoa : 
using System; 


using System.Collections.Generic; 
using System.Ling; 


namespace ProdutividadeEmCSharp 


{ 
class Pessoa 
{ 
public string Nome { get; set; } 
public int Idade { get; set; } 
public char Genero { get; set; } 
3 
public class Program 
{ 
static void Main(string[] args) 
{ 
List<Pessoa> pessoas1 = new List<Pessoa>() 
{ 
new Pessoa(){Nome = "Pedro", Idade = 16, Genero = 
Mb, 
new Pessoa()(Nome = "Paulo", Idade = 18, Genero = 
'M'3, 
new Pessoa()(Nome = "Marcela", Idade = 16, Genero 
='F'}, 
new Pessoa(){Nome = "Roberta", Idade = 21, Genero 
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= 'F'}, 


new Pessoa()(Nome = "Ricardo", Idade = 19, Genero 
— 'M'} 
new Pessoa(){Nome = "Sofia", Idade = 14, Genero = 
'F'}, 
new Pessoa(){Nome = "Vanessa", Idade = 22, Genero 
— 'F'} 
new Pessoa(){Nome = "Rodrigo", Idade = 20, Genero 
— 'M'} 
new Pessoa(){Nome = "Rebeca", Idade = 25, Genero 
— 'F'} 
3; 
List<Pessoa> pessoas2 = new List<Pessoa>() 
{ 
new Pessoa(){Nome = "Henrique", Idade = 13, Gener 
o — 'M'} 
new Pessoa(){Nome = "Pâmela", Idade = 21, Genero 
— 'F'} 
new Pessoa(){Nome = "Alessandra", Idade = 19, Gen 
ero = 'F' 3, 
new Pessoa(){Nome = "Pedro", Idade = 16, Genero = 
'M'3 
new Pessoa()(Nome = "Vanessa", Idade = 22, Genero 
= 'E'S 
3; 


var resultado = pessoasi.Select(p => new ( p.Nome, p. 
Idade, p.Genero 3).Union(pessoas2.Select(p => new ( p.Nome, p.Ida 
de, p.Genero ))).ToList(); 


Console.writeLine("Pessoas selecionadas para a viagem 


Ea a 
foreach (var item in resultado) 
{ 
Console.WriteLine($"* {item.Nome}"); 
3 
3 
3 
3 


Para os cenários em que você precisa juntar duas fontes de 
dados em uma sem remover itens duplicados, utilize o método 
Concat em vez de Union. 
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7.5 EMPREGANDO DIFERENTES TIPOS DE 
JUNÇÕES 


As associações suportadas pelo LINQ são semelhantes às 
junções (em inglês, joins) do SQL. Se você já está familiarizado com 
bancos de dados relacionais, não terá dificuldade em entender 
como construir as consultas equivalentes no LINQ. Para a grande 
maioria dos desenvolvedores e desenvolvedoras, o principal 
problema é recordar a sintaxe adotada, que não é muito intuitiva. 


Uma junção é um tipo de consulta que mescla os dados de duas 
ou mais fontes de dados (objetos ou tabelas) em um único conjunto 
de resultados com base em alguma propriedade comum e permite 
também que sejam aplicadas algumas condições, se necessário. 


O LINQ disponibiliza dois métodos para executar operações de 
junção. São eles: 


e Join - Operador usado para unir duas fontes de dados 
com base na propriedade comum e retorna os dados como 
um único conjunto de resultados. 

e GroupJoin - Operador usado para unir duas fontes de 
dados com base em uma chave ou propriedade comum, 
mas retorna o resultado como um grupo de sequências. 


Existem quatro tipos de junções a serem consideradas quando 
trabalhamos com LINQ. Confira na imagem a seguir: 
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INNER JOIN RIGHT JOIN 


LEFT JOIN FULL JOIN 


Figura 7.4: Tipos de junções suportadas pelo LINQ 


Nas próximas subseções, veremos cada uma dessas junções 
suportadas, apresentando exemplos com a sintaxe de consulta que 
é muito mais intuitiva e fácil de ler que a sintaxe de método. 


Junção interna (Inner Join) 


A primeira junção que aprendemos ao estudar LINQ ou SQL é 
a junção interna ou Inner Join. Esse tipo de junção traz apenas a 
intersecção entre as duas fontes de dados, ou seja, retorna apenas 
os elementos correspondentes de ambas as fontes de dados. 


No exemplo a seguir, a consulta trará os empregados que estão 
associados a departamentos existentes em uma empresa: 


using System; 
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using System.Collections.Generic; 
using System.Ling; 


namespace ProdutividadeEmCSharp 


{ 
public class Empregado 
{ 
public string Nome { get; set; } 
public int Idade { get; set; } 
public char Sexo { get; set; } 
public int DepartamentoId { get; set; } 
3 
public class Departamento 
{ 
public int Id { get; set; } 
public string Nome { get; set; } 
public string Localizacao { get; set; } 
3 


public class Program 
{ 
static void Main(string[] args) 
{ 
List<Empregado> empregados = new List<Empregado> 
{ 
new Empregado() { Nome = 
"Ramon" , Idade = 38, Sexo = 'M', DepartamentoId = 1 }, 
new Empregado() { Nome = 
"Cláudio" , Idade = 46, Sexo = 'M', DepartamentoId = 1 }, 
new Empregado() { Nome = 
"Leonardo" , Idade = 25, Sexo = 'M', DepartamentoId = 4 }, 
new Empregado() { Nome = 
"Luana" , Idade = 22, Sexo = 'F' , DepartamentoId = 3}, 
new Empregado() { Nome = 
"Fernanda" , Idade = 35, Sexo = 'F' , DepartamentoId = 0}, 
new Empregado() { Nome = 
"Natália" , Idade = 25, Sexo = 'F', DepartamentoId = 2 } 
3; 


List<Departamento> departamentos = new List<Departame 
nto> 


new Departamento() { Id=1 
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, Nome = "TI" , Localizacao = "São Paulo" 3, 
new Departamento() { Id=2 


, Nome = "RH" , Localizacao = "São Paulo" 3, 

new Departamento() { Id=3 
, Nome = "Comercial" , Localizacao = "Alphaville" 3, 

new Departamento() { Id=4 
, Nome = "Financeiro" , Localizacao = "Alphaville" 3, 

new Departamento() { Id=5 
, Nome = "Marketing" , Localizacao = "Alphaville" 3 

3; 


var resultado = from empregado in empregados 
join departamento in departamentos 
on empregado. DepartamentoId equals de 
partamento. Id 
select new 


{ 
Nome = empregado. Nome, 
Departamento = departamento. Nome, 
Localizacao = departamento. Locali 
zacao 
J; 


Console.WwriteLine("Exemplo de INNER JOIN:\n"); 


foreach (var item in resultado) 


{ 


Console.wWriteLine($"(item.Nome) - {item.Departame 
nto) - (item.Localizacao)"); 


} 


Ao examinar a consulta LINQ, note que a coluna ou 
propriedade que relaciona as duas fontes de dados é especificada 
na cláusula on . Neste exemplo, ela tem nomes diferentes nas duas 
entidades ( DepartamentoId em Empregado e Id em 

Departamento ): 


var resultado = from empregado in empregados 
join departamento in departamentos 
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on empregado. DepartamentoId equals de 
partamento. Id 
select new 


{ 
Nome = empregado. Nome, 
Departamento = departamento. Nome, 
Localizacao = departamento. Locali 
zacao 
J; 


Confira a saída produzida por esta consulta na imagem a 
seguir: 





E CAWINDOWS\system32\cmd.exe — o pi 
Exemplo de INNER JOIN: ^ 


Ramon - TI - São Paulo 

Cláudio - TI - São Paulo 

Leonardo - Financeiro_- Alphaville 

Luana - Comercial - Alphaville 

Natália - RH - São Paulo 

Pressione qualquer tecla para continuar. . . m 











Figura 7.5: Exemplo de junção interna 


Observe que os elementos não correspondentes entre as duas 
fontes de dados foram removidos do conjunto de resultados (em 
nosso exemplo, apenas a Fernanda foi descartada). Note também 
que a consulta retorna uma coleção de um tipo anônimo que 
possui apenas os campos necessários ( Nome , Departamento e 


Localizacao ). 


Junção externa esquerda (Left Outer Join) 


A junção externa esquerda (em inglês, left outer join) ou 
simplesmente junção esquerda é uma junção na qual cada dado da 
primeira fonte de dados será retornado, independentemente de ter 
ou não dados correlatos presentes na segunda fonte de dados. Nos 
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casos em que não houver dados correspondentes na fonte de dados 
esquerda, serão necessários valores nulos para a segunda fonte de 


dados. 


A implementação de uma junção externa esquerda é feita em 
duas etapas. Na primeira, é necessário executar uma junção interna 
usando uma junção de grupo com a palavra-chave into , deste 
modo: 
var resultado = from empregado in empregados 


join departamento in departamentos 
on empregado. DepartamentoId equals departamento. I 


into temp 


Na segunda etapa, precisamos incluir cada elemento da 
primeira fonte de dados (situada à esquerda) no conjunto de 
resultados, independentemente de esse elemento não ter 
correspondências na segunda fonte de dados (à direita). Para isso, 
precisamos chamar o método  DefaultIfEmpty em cada 
sequência de elementos correspondentes da associação ao grupo. 
Veja: 
var resultado = from empregado in empregados 


join departamento in departamentos 
on empregado. DepartamentoId equals departamento. I 


into temp 
from dx in temp.DefaultIfEmpty() 
select new 


{ 
Nome = empregado. Nome, 
Departamento = (dx != null) ? dx.Nome : "Não 
Informado", 
Localizacao = (dx != null) ? dx.Localizacao 
"Não Informado" 
3; 


Console.writeLine("Exemplo de LEFT OUTER JOIN:An"); 


7.5 EMPREGANDO DIFERENTES TIPOS DE JUNÇÕES 203 


Ao analisar essa consulta, lembre-se de que o valor padrão para 
um tipo de referência é nulo. Consequentemente, é necessário 
verificar a referência nula antes de acessar cada elemento da 
coleção de departamentos. Aproveitamos a necessidade do teste 
para incluir a mensagem Não Informado em vez de 
simplesmente exibir null . Confira o resultado na imagem a 
seguir: 





ES CAWINDOWSisystem32Acmd,exe — o Pas 
Exemplo de LEFT OUTER JOIN: A 


Ramon - TI - São Paulo 

Cláudio - TI - São Paulo 

Leonardo - Financeiro - Alphaville 

Luana - Comercial - Alphaville 

Fernanda - Não Informado - Não Informado 
Natália - RH - São Paulo 

Pressione qualquer tecla para continuar. . . 











Figura 7.6: Exemplo de junção externa esquerda 


Conforme você deve ter percebido, implementar uma junção 
externa esquerda em LINQ ou SQL não é algo tão trivial e intuitivo 
como gostaríamos. A boa notícia é que, para implementar a junção 
externa direita (em inglês, right outer join), basta trocar a ordem 
das fontes de dados. 


Junção cruzada (Cross Join) 


Ao combinarmos duas fontes de dados usando a junção 
cruzada (em inglês, cross join), cada elemento da primeira fonte de 
dados será mapeado com cada elemento da segunda fonte de 
dados. O resultado é um produto cartesiano das fontes de dados 
envolvidas na junção. 


A junção cruzada é mais simples de montar do que a junção 
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interna e a junção externa esquerda, pois não utiliza a palavra- 
chave on para especificar uma propriedade comum que não é 
usada neste tipo de junção e também não há filtragem de dados. 
Veja a seguir um exemplo: 


using System; 
using System.Ling; 


namespace ProdutividadeEmCSharp 





{ 
public class Program 
{ 
static void Main(string[] args) 
{ 
char[] vogais = "AEIOU".ToCharArray(); 
char[] digitos = "123456789".ToCharArray(); 
var posicoes = 
from v in vogais 
from d in digitos 
select v.ToString() + d; 
foreach (var posicao in posicoes) 
{ 
Console.write($"(posicao) "); 
if (posicao.EndsWith("9")) Console.wWriteLine(); 
3 
3 
3 
} 
Confira a saída produzida por este código na próxima imagem: 
ES CAWINDOWS\system32\cmd.exe — o > 


1 A2 A3 A4 A5 A6 A7 A8 A9 
1 E2 E3 E4 E5 E6 E7 E8 E9 
CE T2 13 L4 15 16. 17 18 19 
102030405 06 07 08 09 
ui u2 U3 U4 U5 U6 U7 u8 u9 
ressione qualquer tecla para continuar. 








Figura 7.7: Exemplo de junção cruzada 
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Vale destacar que, neste tipo de junção, o número total de 
elementos na sequência resultante será o produto das duas fontes 
de dados envolvidas na junção (5 vogais x 10 dígitos = 50 
elementos). 


7.6 ORDENANDO O RESULTADO DAS 
CONSULTAS 


Ao criarmos consultas LINQ, muitas vezes desejamos que os 
elementos sejam retornados em uma ordem ascendente ou 
descendente. Para ordenar elementos de um tipo complexo de 
forma ascendente, basta adicionar na consulta a cláusula orderby 
antes da cláusula select , especificando o nome da propriedade 
usada para fins de ordenação: 
var resultado = from p in pessoas 

where p.Sexo == 'F' 


orderby p.Nome 
select p.Nome; 


Confira: 





EH CAWINDOWS\system32\cmd.exe — o x 


Pessoas do sexo feminino: A 
Cristiane 

Flavia 

Iara 

Pressione qualquer tecla para continuar. . . 











Figura 7.8: Ordenando os resultados de maneira ascendente 


Caso deseje ordenar o resultado em ordem descendente, utilize 
a consulta a seguir: 


var resultado = from p in pessoas 
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where p.Sexo == 'F' 
orderby p.Nome descending 
select p.Nome; 


Para aplicar a ordenação descendente no exemplo em que 
empregamos uma expressão regular sobre uma lista de strings, 
bastaria alterar a consulta como mostrado a seguir: 
var resultado = from n in nomes 

where regex. IsMatch(n) 
orderby n descending 
select n; 

Muito fácil, não é mesmo? E o melhor de tudo é que para 
ordenar mais de uma coluna usando a sintaxe de consulta é 
igualmente simples. No exemplo a seguir, utilizamos como 
primeiro critério de ordenação o sexo e como segundo, a idade: 
var resultado = from p in pessoas 


orderby p.Sexo, p. Idade 
select p; 


Note que nesta consulta não foi necessário especificar uma 
cláusula where . Para conferir o conjunto de resultados 
retornados por ela, altere o trecho final do exemplo anterior: 


Console.writeLine("Pessoas ordenadas por sexo e idade:An"); 
foreach (var item in resultado) 


{ 

Console.WriteLine($"(item.Nome) - {item.Sexo} - {item.Idade}" 
); 
} 

Executando uma vez mais o programa, você obterá a seguinte 
saída: 
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ER CNWINDOWSisystem32Acmd.exe — o aY 
Pessoas ordenadas por sexo e idade: A 


fara = F = 2 

Flavia - F - 38 

ristiane - F - 43 

Renan SAM a5 

láudio - M - 46 

Pressione qualquer tecla para continuar. . . m 











Figura 7.9: Ordenando de maneira ascendente os resultados por mais de um critério 


Para reescrever a consulta anterior usando a sintaxe de 
métodos, teríamos que usar um operador OrderBy ou 
OrderByDescending para especificar a primeira propriedade de 
ordenação e um operador ThenBy para especificar a segunda 
propriedade de ordenação, sendo possível acrescentar mais 
chamadas ao método ThenBy para propriedades extras. Veja: 


var resultado = pessoas.OrderBy(p => p.Sexo).ThenBy(p => p.Idade) 

É importante destacar que LINQ é um assunto muito vasto que 
preencheria facilmente um livro inteiro mais extenso do que este 
que você está lendo agora. Ao longo deste capítulo, limitamo-nos a 
apresentar alguns recursos úteis disponíveis neste modelo de 
programação para despertar a curiosidade dos leitores e leitoras 
que ainda não vivenciaram a experiência de trabalhar com LINQ 
em seus projetos. 
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Para aqueles que utilizam LINQ de forma extensiva, uma 
ferramenta que não pode faltar é o LINQPad. O LINQPad 6 é 
compatível com as novidades introduzidas no C# 8 e no .NET 
Core 3.x e inclui vários templates de código prontos para fins 
de estudo. Você pode baixar a versão gratuita do programa, 
acessando: 


https://www.lingpad.net/Download.aspx 


Até o momento em que este livro estava sendo finalizado 
(outubro de 2020), ainda não havia nenhuma versão deste 
software compatível com o .NET 5.0. 


Para saber mais sobre a criação de consultas LINQ, acesse a 
seguinte página da documentação oficial: 


https://docs.microsoft.com/pt- 
br/dotnet/csharp/programming- 


guide/concepts/linq/introduction-to-ling-queries 
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CarírtuLo 8 


EXCEÇÕES 


As exceções ou exceptions são mecanismos primários 
fornecidos por linguagens, como Cf, Visual Basic e Java para 
comunicar ao sistema ou script condições de erros ocorridos 
dentro do código, como a indisponibilidade de acesso à internet ou 
a uma API, incapacidade de conectar ao banco de dados com as 
credenciais passadas, erros de leitura ou escrita em um arquivo em 
uma pasta, efetuar a divisão de um número por zero etc. 


Para tratar exceções, usamos estruturas try-catch e try- 
catch-finally , nas quais é frequente a presença de múltiplos 
blocos catch , voltados para diferentes tipos de exceções, e um 
bloco genérico disposto ao final, com o objetivo de capturar 
exceções que não foram capturadas pelos blocos anteriores mais 
especializados. 


Para facilitar o nosso trabalho, o Visual Studio fornece a janela 
Configurações de Exceção, que vamos utilizar para interromper a 
execução quando um tipo específico de exceção for gerado. Você 
verá que é possível definir condições e que a interrupção da 
execução ocorre tanto com exceções tratadas quanto com as não 
tratadas. Com a execução pausada poderemos examinar a exceção 
lançada usando ferramentas como a janela de Inspeção ou janela 
de Inspeção Rápida, que serão detalhadas no capítulo sobre 
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depuração. 


Uma exceção contém informações valiosas para o 
desenvolvedor, como a mensagem de erro, mantida na 
propriedade Message , e a pilha de chamadas, disponível na 
propriedade StackTrace . Além disso, pode conter ou não outra 
exceção, motivo pelo qual devemos sempre inspecionar a sua 
propriedade InnerException . Por meio dessa propriedade, 
temos acesso à exceção pai que causou a interrupção no fluxo 
normal de execução. 


O Cf nos permite lançar de forma explícita uma exceção 
usando a instrução throw ou relançar uma exceção capturada em 
um bloco catch após executar algum tratamento local usando a 
mesma instrução throw. 


Para localizar a origem dos erros, veremos como rastrear o 
fluxo de execução inspecionando a janela Pilha de Chamadas, o 
que nos permitirá encontrar exceções não tratadas tanto no código 
do usuário quanto de terceiros ou do próprio framework. 


A partir do C& 6.0, a linguagem passou a oferecer suporte a 
algumas melhorias no tratamento de exceções que facilitam a vida 
do desenvolvedor e que serão detalhadas neste capítulo. Nas 
próximas seções, você aprenderá como empregar filtros de exceções 
(inclusive na criação de log de erros) e como efetuar o tratamento 
de exceções em métodos assíncronos. Além disso, entenderá como 
relançar exceções sem perder o conteúdo da pilha de chamadas, 
um erro frequente entre os desenvolvedores, e descobrirá que 
podemos acessar informações sobre a última exceção lançada 
consultando a pseudovariável $exception. 
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Veremos que é possível estender a classe Exception do 
namespace System (a classe base de todas as exceções em Cf), e 
criar exceções contendo propriedades e métodos extras adequados 
às suas necessidades. O capítulo termina mostrando como gerar, 
em poucos segundos, o esqueleto de uma classe de exceção 
personalizada usando o recurso Gerar a partir do uso. 


8.1 CRIANDO BLOCOS DE TRATAMENTO DE 
EXCEÇÕES USANDO CODE SNIPPETS 


O editor de código do Visual Studio dispõe de vários atalhos 
(em inglês, code snippets) para a inserção de blocos de tratamento 
de exceções e para a definição de uma classe que herde de 
Exception . Confira os atalhos na tabela a seguir: 


pa Locais válidos para inserir o 
Atalho Descrição N Pp 

snippet 
Cria uma declaração para uma 


: Dentro de um namespace 
classe que deriva de uma 


exception = . (incluindo o namespace global), 
exceção ( Exception por 
A uma classe ou uma estrutura. 
padrão). 
Dentro de um método, um 
try Criaumbloco try-catch . indexador, um acessador de 
propriedade ou um acessador de 
evento. 
Dentro de um método, um 
Cria um bloco try- indexador, um acessador de 
tryf : i 
finally. propriedade ou um acessador de 


evento. 


Descobrindo rapidamente quais tipos de exceções 
cada classe do framework pode disparar 


Uma forma simples de descobrir que tipos de exceções cada 
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classe do framework .NET/.NET Core pode disparar é parar com o 
mouse sobre o nome da classe no editor de código. 


Para testar, entre com o código de exemplo a seguir: 
using System. IO; 


namespace ProdutividadeEmCSharp 


i class Program 
{ 
static void Main(string[] args) 
{ 
StreamReader sr = new StreamReader ("produtividade.txt 
); 
3 
3 
3 


Com o código já disponível, pare com o mouse sobre a classe 
StreamReader e inspecione as informações mostradas na tooltip. 
Confira na imagem a seguir: 


CEEE o 

















[cx] ProdutividadeEmCSharp = L% ProdutividadeEmCSharp.Program 

1 Husin tem; 

2 | using System. IO; 

3 

4 [namespace ProdutividadeEmCSharp 

5 1 

6 E class Program 

7 

9 E static void Main(string[] args) 

10 

11 StreamReader sr = new StreamReader "produtividade. txt"); 

12 

13 } } O StreamReader.StreamReader(string path) (+ 10 sobrecargas) 

q Initializes a new instance of the StreamReader class for the specified file name. 
15 (N Exceções: 


ArgumentException 
ArgumentNullException 
FileNotFoundException 
DirectoryNotFoundException 
lOException 


Figura 8.1: Descobrindo os tipos de exceção que podem ser disparados por um classe 
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E o melhor de tudo é que os nomes das classes de exceção 
listados são links para a documentação da classe gerada a partir de 
metadados, ou seja, basta um clique em FileNotFoundException 
para inspecionarmos os membros da classe. Veja: 


Program.cs 














[es] System. Runtime 








* System. IO.FileNotFoundException 





























5 using [...] 
37 
38 =|jnamespace System. IO 
39 
4 E [public class FIENSEESMMMENEERNISA : 10xception 
47 { 
48 = - - [public FileNotFoundexception(); 
5 E public FileNotFoundexception(string? message); 
q E public FileNotFoundException(string? message, Exception? innerException); 
a E public FileNotFoundException(string? message, string? fileName); 
9 E public FileNotFoundexception(string? message, string? fileName, Exception? innerException); 
114 + protected FileNotFoundException(SerializationInfo info, StreamingContext context); 
127 
128 E [.. public string? FileName { get; } 
136 E public string? FusionLog ( get; ) 
147 E] [-. public override string Message ( get; ) 
155 
156 + [.. public override void GetObjectData(SerializationInfo info, StreamingContext context); 
169 + public override string ToString(); 
179 
180 } 


Figura 8.2: Inspecionando os membros da classe FileNotFoundException 


8.2 TRATANDO EXCEÇÕES USANDO FILTROS 
DE EXCEÇÕES 


Um filtro de exceção é um recurso introduzido no C# 6.0 que 
fornece muita flexibilidade para os desenvolvedores lidarem com 
as exceções. Durante a captura das exceções, eles fornecem 
instruções condicionais que retornam true ou false ao bloco 

catch . Veja a seguir um exemplo: 


try 
{ 


//Código que dispara a exception 


} 


catch (Exception e) when (e.InnerException != null) 


{ 


//Código que trata a exception 
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3 
finally 


{ 
} 


Conforme você pode observar, uma instrução when foi 
adicionada à direita do bloco de exceção. Isso significa que o bloco 
de código só será executado se a condição especificada for 
verdadeira. 


É possível especificar vários níveis de bloco catch com 
condições diferentes e assim implementar uma abordagem de 
fallback. O próximo fragmento de código ilustra este tipo de 
construção mais complexa: 


try 
{ 
//Código que dispara a exception 
3 
catch (InvalidOperationException ioe) when (e. InnerException != n 
ull) 
{ 
//Código que trata a exception 
} 
catch (FieldAccessException fae) when (e.InnerException != null) 
{ 
//Código que trata a exception 
} 
catch(Exception exp) 
{ 
//Código que trata a exception 
} 
finally 
{ 
3 


Confira na próxima listagem um exemplo executável de uso da 
filtragem de exceção: 


using System; 
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namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
try 
{ 
Console.writeLine("Disparando a exceção..."); 
throw new ArgumentNullException(paramName: "idade 
); 
3 
catch (ArgumentNullException e) when (e.ParamName == 
"nome" ) 
{ 
Console.WriteLine("Capturando a exceção dentro do 
bloco que contém o filtro nome..."); 
3 
3 
3 
3 


Ao executar esse exemplo, veremos que a exceção continua 
sendo disparada, pois forjamos no bloco Try uma exceção do 
tipo ArgumentNullException que teria sido disparada por um 
parâmetro fictício idade , e o filtro que criamos só é ativado 
quando o parâmetro é nome . Veja: 





ES CNWINDOWSisystem32cmd.exe — o xX 


Disparando a exceção... . 

Pohandled exception. System.ArgumentNullException: Value cannot be null. (Parameter 
idade 

at ProdutividadeEmCSharp.Program.Main(String[] args) in C:\Users\Claudio\source\ 
reposYProdutividadeEmCsharpiProdutividadeEmCsharpYProgram.cs: line 12 

Pressione qualquer tecla para continuar. . . m 











Figura 8.3: Falha no uso da filtragem de exceção 


Para lidar com o problema que criamos, vamos fornecer um 
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mecanismo de fallback, incluindo um bloco catch extra que será 
disparado caso nenhum case anterior no fluxo seja ativado: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
try 
{ 
Console.writeLine("Disparando a exceção..."); 
throw new ArgumentNullException(paramName: "idade 
); 
3 
catch (ArgumentNullException e) when (e.ParamName == 
"nome" ) 
{ 
Console.WriteLine("Capturando a exceção dentro do 
bloco que contém o filtro nome..."); 
} 
catch (Exception e) 
{ 


Console.writeLine("Capturando a exceção dentro do 
bloco catch sem filtro."); 


} 





EA CAWINDOWS\system32\cmd.exe — o xX 


isparando a exceção... 3 A 
apturando a exceção dentro do bloco catch sem filtro. 
Pressione qualquer tecla para continuar. . 


v 





Figura 8.4: Utilizando um mecanismo de fallback em conjunto com a filtragem de exceção 


Agora que já temos o programa de teste capturando todas as 
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exceções, vamos alterar o filtro para que possamos vê-lo em 
funcionamento. Altere o nome do parâmetro de nome para 
idade : 


catch (ArgumentNullException e) when (e.ParamName == "idade") 


{ 
Console.writeLine("Capturando a exceção dentro do bloco que c 
ontém o filtro idade..."); 


J 


Execute uma vez mais o exemplo e confira que o filtro funciona 
como esperado: 








CAWINDOWS\system32\cmd.exe = x 











Disparando a exceção... ; . E 
Kapturando a exceção dentro do bloco que contém o filtro idade... 
Pressione qualquer tecla para continuar. . 











Figura 8.5: Capturando com sucesso uma exceção usando filtragem de exceção 


8.3 EFETUANDO LOG DE ERROS USANDO 
FILTROS DE EXCEÇÕES 


A funcionalidade filtro de exceção pode ser usada para 
implementar facilmente um mecanismo de log, uma vez que 
permite ter acesso à pilha de chamadas sem destruí-la. Para tanto, 
basta que o filtro criado retorne false , como no exemplo a 
seguir, no qual codificamos uma função log muito simples, apenas 
para exemplificar a ideia: 


using System; 
using System. Diagnostics; 


namespace ProdutividadeEmCSharp 


{ 


class Program 
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{ 


static bool Log(Exception ex, string message, params obje 


ct[] args) 
{ 
Debug.Print(message, args); 
return false; 
3 
static void Main(string[] args) 
{ 
try 
{ 
Console.writeLine("Disparando a exceção..."); 
throw new ArgumentNullException(paramName: "idade 
); 
} 


catch (ArgumentNullException ex) when (Log(ex, "Parâm 
etro não pode ser nulo!")) 


{ 


Console.writeLine("Capturando a exceção dentro do 
bloco ArgumentNullException..."); 


} 


catch (Exception) 


{ 


Console.writeLine("Capturando a exceção dentro do 
bloco Exception..."); 


} 


Este exemplo utiliza o método Print da classe Debug para 
escrever uma mensagem na janela Saída (em inglês, Output) do 
Visual Studio quando o programa é executado em modo 
depuração, além de escrever na janela de console. Para exibir a 
janela Saída, clique no menu Depurar, no submenu Janelas e, a 
seguir, na opção Saída. Veja: 
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Mostrar saída de: Depuração X = d 
Parâmetro não pode ser nulo! a 


Figura 8.6: Inspecionando a mensagem de log na janela de Saída do Visual Studio 


Para saber mais sobre o uso dos filtros de exceções em C#, 
acesse a seguinte página da documentação oficial: 


https://docs.microsoft.com/pt-br/dotnet/csharp/whats- 


new/csharp-9#exception-filters 





8.4  INSPECIONANDO A PILHA DE 
CHAMADAS 


A janela Pilha de Chamadas (em inglês, Call Stack) é usada 
para nos mostrar a pilha de chamadas de métodos e só está 
disponível durante a sessão de depuração. 


Na prática, isso significa que devemos primeiro setar um ponto 
de interrupção, executar o programa em modo debug e, ao atingi- 
lo, carregar a janela Pilha de Chamadas. Para exibir a janela, clique 
no menu Depurar, selecione o submenu Janelas e, a seguir, a opção 
Pilha de Chamadas ou simplesmente tecle Ctrl + Alt + c. 


Para ilustrar o uso desta ferramenta, vamos partir do código do 
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exemplo a seguir: 
using System; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Metodo2(string mensagem) 
{ 
Console.WwriteLine(Metodo1(mensagem)); 
3 
static string Metodo1(string mensagem) 
{ 
return $"Mensagem: {mensagem}\nTamanho: {mensagem.Len 
gth}"; 
3 
static void Main(string[] args) 
{ 
Metodo2( "Produtividade em C#"); 
Metodo2(null); 
3 
3 
} 


Antes de executar o programa, marque um ponto de 
interrupção na primeira chamada ao Metodo2 no método Main. 
Execute o programa em modo de depuração e exiba a janela 
conforme explicado anteriormente. Ao executar a segunda 
chamada ao Metodo2 , uma exceção será lançada e será possível 
inspecionar a pilha. Veja na imagem a seguir: 
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Dé) Arquivo Editar Exibir Projeto Compilação Depurar Teste Análise Ferramentas Extensões Janela PJ EE “65x 
Ajuda 
©- mi 9- > Continuar - Si [E a O|! t| isis plena E 
-ẹ 
8 
[E ProdutividadeEmCSharp ~ ProdutividadeEmCSharp.Program - Pa Metodo! (string mensagem) A, 
raji 
3 =namespace ProdutividadeEmCSharp ql 
4 { $ 
5 E 
a 
e g 
E class Program 
t 
3 TE static void Metodo?2(string mensagem) 
9 { 
10 Console.WriteLine(Metodo1l(mensagem)); 
11 } 
12 Í ' 
13 E static string Metodol(string mensagem) 
14 É 
$% isg Feturn $"Men © 
16 } 
17 Exceção Sem Tratamento =x 
18 É static void Main(string[] ) System NullReferenceException: 'Object reference not set to an 
5 t instance of an object: 
os etodo2( "Produtividade em CH"); e 
21 Metodo2 (null); 
22 
23 e 
sa ; Exibir Detalhes | Copiar Detalhes | Inicie a Sessão do Live Share... 
b Configurações de Exceção 
121% >~ © Não foi encontrado nenhum problema fv 4 + Ln:15 Car13 SPC CRLF 
Pilha de Chamadas 1x 
Nome Linguagem Status do! 
© ProdutividadeEmCSharp.dIl!ProdutividadeEmCSharp.Program.Metodo (string mensagem)Linha 15 c Símbolo... 
ProdutividadeEmCSharp.dil!ProdutividadeEmCSharp.Program.Metodo?(string mensagem)Linha 10 cs Símbolo... 
ProdutividadeEmCSharp.dil!ProdutividadeEmCSharp.Program.Main(string[] args)Linha 21 cë Símbolo... 





Figura 8.7: Exibindo a janela Pilha de Chamadas 


Ao inspecionar a janela Pilha de Chamadas, considere que o 
rastreamento de pilha começa no método do nosso código. Nele a 
exceção é lançada (sinalizado pela seta amarela) e termina no 
método que contém o bloco try...catch que captura a exceção, 
caso exista, ou no método main , que é o ponto de entrada da 
nossa aplicação de console, no caso de uma exceção não tratada. 
Observe que a janela mostra em destaque a linha de execução atual 
e informa, sempre que possível, a linguagem usada para escrever 
cada método. Confira: 
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Pilha de Chamadas 7x 





Nome Linguagem Status do Quadro 
| > | ProdutividadeEmCSharp.dil'ProdutividadeEmCSharp.Program. Metodo! (string mensagem)Linha 15 | C# Símbolos carregados. 
ProdutividadeEmCSharp.dil!ProdutividadeEmCSharp.Program.MetodoZ(string mensagem)Linha 10 C* Símbolos carregados. 


ProdutividadeEmCSharp.dll!ProdutividadeEmCSharp.Program.Main(string[] args)Linha 21 cë Símbolos carregados. 


Figura 8.8: Inspecionando a ordem de chamada dos métodos na janela Pilha de Chamadas 


Para visualizar os valores passados para os parâmetros de cada 
método, clique com o botão direito sobre um dos itens listados e 
selecione no menu de contexto a opção Mostrar Valores de 


Parâmetro. Veja: 


Pilha de Chamadas 





Nome Linguagem Status do Quadro 





| + | ProdutividadeEmCSharp.dll!ProdutividadeEmCSharp.Progrem.Metodo1 (string mensagem = null)Linha 15 |C# | Símbolos carregados. | 
ProdutividadeEmCSharp.dll!ProdutividadeEmCSharp.Program.Metodo2(string mensagem = null)Linha 10  C# Símbolos carregados. 
ProdutividadeEmCSharp.dll!ProdutividadeEmCSharp.Program.Main(string[] args = {string[0]}) Linha 21 cë Símbolos carregados. 


Figura 8.9: Inspecionando os valores passados para os métodos 


Por meio dessa janela, podemos também adicionar, desabilitar 
e remover pontos de interrupção simplesmente clicando sobre o 
procedimento desejado e selecionando no menu de contexto as 
opções do submenu Ponto de Interrupção. Note que você pode 
efetuar um duplo clique sobre o nome de um método do seu 
projeto listado nesta janela para ver o código-fonte. 


A janela Pilha de Chamadas é mais poderosa do que pode 
parecer em um primeiro momento, pois nos permite inspecionar 
não apenas a pilha de chamadas envolvendo o código que 
desenvolvemos, como também as chamadas às bibliotecas de 
terceiros e aos métodos do próprio framework, nos quais exceções 
também podem ocorrer. Mais adiante neste capítulo, explicaremos 
como habilitar a visualização desse tipo de rastreamento. 
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8.5 PRESERVANDO A PILHA DE CHAMADAS 


Um detalhe importante a ser lembrado ao relançar uma 
exceção sem adicionar informações adicionais, é o de usar: 


throw; 
No lugar de: 
throw ex; 


Uma instrução throw vazia em um bloco catch emitirá um 
IL específico que lança novamente a exceção enquanto preserva o 
rastreio da pilha original (stack trace). Já uma instrução throw 
ex perderá o rastreamento de pilha para a fonte original da 
exceção e conterá apenas as informações que você especificar. 


Para testar, execute o programa a seguir: 


using System; 
using System.Diagnostics; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void GerarException() 
{ 
Console.writeLine("Disparando a exceção..."); 
throw new ArgumentNullException(paramName: "idade"); 
3 
static void Main(string[] args) 
{ 
try 
{ 
GerarException(); 
3 
catch (Exception ex) 
{ 
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throw; 
//throw ex; 





É 
3 
3 
} 
Utilizando a instrução throw vazia, obteremos a saída a 
seguir: 
CAWINDOWS\system32\cmd.exe = o e 


“idade 
at ProdutividadeEmCsharp.Program.GerarException() in C:\Users\Claudio\source\rep 
osNProduti eae nad dinda vidadeEmCsharpYProgram.cs: line 12 
at ProdutividadeEmes esticada dia e a args) in C:\Users\Claudio\source\ 
repos di shar piero utividadeEmCSharp\Program.cs:line 19 
ressione qualquer tecla para continuar. . 


Mohanta exception. System.ArgumentNullException: Value cannot be null. (Parameter a 











Figura 8.10: Utilizando a instrução throw 


Repetindo o teste usando a instrução throw ex , obteremos a 
saída mostrada na próxima janela. Compare: 





E CAWINDOWS\system32\cmd.exe = o XxX 


Unhandies exception. System.ArgumentNullException: Value cannot be null. (Parameter a 
idade 

at co pd pe E qi a args) in C:\Users\Claudio\source\ 
reposYProdutividadeEmCsharpYProdutividadeEmCsharpYProgram.cs: line 24 
Pressione qualquer tecla para continuar. . 











Figura 8.11: Utilizando a instrução throw ex 


8.6 UTILIZANDO THROW EM CONTEXTOS 
QUE REQUEREM UMA EXPRESSÃO 


Concebida originalmente para ser uma declaração, a palavra- 
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chave throw não podia ser usada nas primeiras versões da 
linguagem C# em contextos que exigiam uma expressão, como 
dentro de uma declaração ternária. Com o lançamento do C# 7.0, o 
compilador passou a permitir que o throw também seja usado 
como expressão. 


Isso possibilita que utilizemos throw em uma expressão null- 
coalescing como a mostrada no exemplo a seguir: 


using System; 


namespace ProdutividadeEmCSharp 
{ 
class Pessoa 
{ 
private string _nome; 
public string Nome 
{ 
get => _nome; 
set => _nome = value ?? throw new ArgumentNullExcepti 
on(null, $"0 valor da propriedade {nameof(Nome)} não pode ser nul 
oT); 


3 
3 
class Program 
{ 
static void Main(string[] args) 
{ 
try 
{ 
Pessoa pessoa = new Pessoa(); 
pessoa.Nome = null; 
3 
catch (Exception ex) 
{ 
Console.WriteLine($"Erro: {ex.Message}"); 
3 
3 
3 
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Conforme vimos no capítulo sobre operadores, o operador de 
coalescência nula ?? (em inglês,null-coalescing operator) 
retornará o valor do operando esquerdo se não for null, caso 
contrário, ele avaliará o operando direito e retornará seu resultado. 


Também podemos usar throw em um construtor Expression- 
Bodied (em português, corpo de expressão) para disparar a exceção 
quando o construtor recebe null como argumento. Veja: 
public Pessoa(string nome) => nome = nome ?? throw new ArgumentN 
ullException(); 

As definições de corpo da expressão introduzidas no Cf 6.0 e 
melhoradas no C& 7.0 possibilitam a implementação de um 
membro em uma forma bastante concisa e legível. Podemos 
utilizá-las sempre que a lógica para um método, construtor, 
destrutor, indexador ou propriedade, consistir em uma única 
expressão. 


Para testar essa possibilidade, será necessário alterar a linha 
que cria a instância da classe Pessoa conforme mostrado a 
seguir: 


Pessoa pessoa = new Pessoa(null); 


Para saber mais sobre throw em contextos que requerem 
expressões, consulte: 


https://docs.microsoft.com/pt-br/dotnet/csharp/language- 


reference/keywords/throw&the-throw-expression 
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8.7 UTILIZANDO O OPERADOR AWAIT EM 
BLOCOS CATCH E FINALLY 


Antes do lançamento do C 6.0, os desenvolvedores tinham 
que recorrer a todos os tipos de soluções estranhas para trabalhar 
com programação assíncrona e lidar com o tratamento de 
exceções, uma vez que não era possível utilizar a palavra-chave 
await nos blocos catch e finally. A partir desta versão da 
linguagem, já é possível utilizar o operador await sem restrições. 


Embora não pareça uma mudança importante em um primeiro 
momento, é preciso lembrar que o consumo de APIs assíncronas é 
cada dia mais frequente. Além disso, a maioria dos aplicativos 
inclui logging ou recursos similares em cláusulas catch, o que 
pode se tornar mais complicado se o log for implementado como 
uma operação assíncrona em sistemas distribuídos. Como se não 
bastasse, existem ainda cenários em que desejamos executar algum 
trabalho de limpeza assíncrono em uma cláusula finally. 


O exemplo a seguir, extraído da documentação oficial do Cf 
6.0, ilustra como utilizar o operador await nos blocos catch e 
finally de um método assíncrono: 


public static async Task<string> MakeRequestAndLogFailures() 
{ 
await logMethodEntrance(); 
var client = new System.Net.Http.HttpClient(); 
var streamTask = client.GetStringAsync("https://localHost:100 
oo"); 
try { 
var responseText = await streamTask; 
return responseText; 
} catch (System.Net.Http.HttpRequestException e) when (e.Mess 
age.Contains("301")) 
{ 


await logError("Recovered from redirect", e); 


228 8.7 UTILIZANDO O OPERADOR AWAIT EM BLOCOS CATCH E FINALLY 


return "Site Moved"; 


3 

finally 

{ 
await logMethodExit(); 
client.Dispose(); 

3 


Para saber mais sobre o tratamento de exceções em métodos 
assíncronos, consulte a seguinte página da documentação 
oficial: 


https://docs.microsoft.com/pt-br/dotnet/csharp/language- 
reference/keywords/try-catch&exceptions-in-async-methods 





8.8 INTERROMPENDO A EXECUÇÃO 
QUANDO UMA EXCEÇÃO FOR GERADA 


O Visual Studio disponibiliza a janela Configurações de Exceção 
para gerenciamento de exceções. Por meio dela, podemos definir 
qual exceção quebrar, em que ponto interromper, adicionar novas 
exceções e adicionar condições para as exceções. 


Para abrir essa janela, clique no menu Depurar, selecione o 
submenu Janelas e, a seguir, a opção Configurações de Exceção. 
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p= quisar (Ctrl+E) 2 





gerado Condições 





C++ Exceptions 

Common Language Runtime Exceptions 
GPU Memory Access Exceptions 
Java Exceptions 

JavaScript (Chrome) Exceptions 
JavaScript (Edge) Exceptions 
JavaScript (Node.js 8+) Exceptions 
JavaScript Runtime Exceptions 
Managed Debugging Assistants 
Node.js Exceptions 

Python Exceptions 

WebKit JavaScript Exceptions 
Win32 Exceptions 


Figura 8.12: Janela de Configurações de Exceção 


As exceções que nos interessam estão agrupadas na categoria 


Common Language Runtime Exceptions. Expanda este nó e 


inspecione a longa lista de exceções disponíveis: 
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Y fem æ 2= Pesquisar (Ctrl-E) s 


Interromper quando for gerado Condições 





b [M C++ Exceptions 











Common Language Runtime Exceptions 





<Todos os Common Language Runtime Exceptions ausen 
Microsoft. JScript.JScriptException 
System.AccessViolationException 
System.AggregateException 
System.AppDomainUnloadedException 
System.ApplicationException 

System.ArgumentException 
System.ArgumentNullException 
System.ArgumentOutOfRangeException 

System. ArithmeticException 

System.Array TypeMismatchException 
System.BadimageFormatException 
System.CannotUnioadAppDomainException 
System.Collections.Generic.KeyNotFoundException 
System.ComponentModel.Composition.ChangeRejectedE 
System.ComponentModel.Composition.CompositionCon 
System.ComponentModel.Composition.CompositionExct 
System.ComponentModel.Composition.ImportCardinalit, 
System.ComponentModel.Composition.Primitives.Comp: 
System.ComponentModel.DataAnnotations.ValidationExc 
System.ComponentModel.Design.CheckoutException 
System.ComponentModel.Design.ExceptionCollection 
System.ComponentModel.Design.Serialization.CodeDom: 
System.ComponentModel.InvalidAsynchronousStateExce 
System.ComponentModel.InvalidEnumArgumentExceptic 
System.ComponentModel.LicenseException 
System.ComponentModel.WarningException 
System.ComponentModel.Win32Exception 
System.Configuration.ConfigurationErrorsException v 



















































































































































































Figura 8.13: Lista de exceções da Common Language Runtime 


Note que você pode selecionar todo o grupo de exceções da 
Common Language Runtime simplesmente clicando na caixa de 
verificação existente ou pode selecionar uma ou mais exceções 
clicando nas caixas de verificação dos nós que representam os tipos 
de exceção disponíveis. Observe que existe uma opção com o nome 
Todos os Common Language Runtime Exceptions ausentes para 
capturar as exceções não presentes nesta lista. Se preferir, você 
também pode clicar com o botão direito sobre a categoria de 
exceções e selecionar no menu de contexto a opção Adicionar 
Exceção. Neste caso, digite o nome da exceção seguido de enter 
para incluí-la na categoria. 
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A partir do Visual Studio 2017, podemos definir uma condição 
na exceção ou categoria de exceções. Com isso, somente quando 
houver uma condição correspondente, o IDE lançará uma exceção. 


Para definir uma condição, clique com o botão direito do 
mouse sobre a exceção ou grupo de exceções desejado e selecione 
no menu de contexto a opção Editar condições. A caixa de diálogo 
Editar condições será exibida. 


Especifique os nomes dos módulos para os quais você deseja 
gerar a exceção. Use o link Adicionar condição para incluir 
condições extras. Observe no aviso da janela que também é 
possível utilizar coringas na definição da condição e que o tipo de 
exceção afetada pela condição é mostrado no campo Tipo. 





Editar Condições x 


Interrompa a execução quando a exceção "Type" for gerada e as seguintes condições forem atendidas para a localização da exceção 
gerada, Você pode usar curingas (*) para ampliar a condição, por exemplo *AppModule”. 
Tipo:iCommon Language Runtime Exceptions 


Interromper Quando: 





Nome do Módulo “| |Élguala v | [ProdutividadeEmCSharp.dil | x 





Adicionar Condição... 























OK a Cancelar 








Figura 8.14: Definindo uma condição para o lançamento da exceção 


Depois que a condição é aplicada, você verá que ela é exibida 
na coluna de condições da janela Configurações de Exceção. 
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Y fem æ 2= Pesquisar (Ctrl-E) P 


Interromper quando for gerado Condições =s 





b [M C++ Exceptions 








Common Language Runtime Exceptions Nome do Módulo É Igual a “ProdutividadeEmCSharp.dil 
GPU Memory Access Exceptions 
W| Java Exceptions 
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b 

b JavaScript (Chrome) Exceptions 
b JavaScript (Edge) Exceptions 

b JavaScript (Node.js 8+) Exceptions 
b 

b 
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b 
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Œ| JavaScript Runtime Exceptions 
@| Managed Debugging Assistants 
Node.js Exceptions 

Python Exceptions 

WebKit JavaScript Exceptions 



































v 


Figura 8.15: Condição de lançamento da exceção sendo listada na janela Configurações de 
Exceção 


Essa funcionalidade é particularmente útil quando precisamos 
ignorar temporariamente algumas bibliotecas (que desenvolvemos 
ou foram criadas por terceiros) das quais já conhecemos os 
problemas existentes, enquanto investigamos novos bugs em outra 
parte do código. 


Para experimentar na prática como essa janela afeta a nossa 
forma de trabalhar, vamos partir do exemplo a seguir: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
public static void DisparaETrataExcecao() 
{ 
try 
{ 
throw new AccessViolationException(); 
3 
catch (Exception e) 
{ 


Console.WriteLine($"Tratei a exceção! Mensagem: { 
e.Message}"); 


} 
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public static void DisparaExcecaoNaoTratada() 


i throw new AccessViolationException(); 
3 
static void Main(string[] args) 
{ 
DisparaETrataExcecao(); 
DisparaExcecaoNaoTratada(); 
3 


Ao analisar o código, note que temos um método 

DisparaETrataExcecao que gera uma exceção e a manipula, e 

um segundo método DisparaExcecaoNaoTratada que gera a 
mesma exceção sem tratá-la. 


Na janela Configurações de Exceção, limpe as configurações 
anteriores clicando no botão Restaurar a lista para as configurações 
padrões presente na barra de botões e, em seguida, selecione o tipo 
de exceção  System.AccessViolationException conforme 
mostrado na imagem a seguir: 








esquisar (Ctrl+ E) P 


YTl+=2 5] 


Interromper quando for gétado Condições 





4 [] Common Language Runtime Exceptions 





<Todos os Common Language Rúntime Exceptions ausen 
[J Microsoft JScript Scriptêxception “55s, 


FTX] System AccessViolationException 1 restaura a lista para as configurações padrão 
System.AggregateException 

System.AppDomainUnioadedException 

System.ApplicationException 

System.ArgumentException 


System. ArgumentNullException hd 


















































Figura 8.16: Filtrando apenas a exceção AccessViolationException 


Uma vez feita a configuração, já podemos teclar F5 para testar. 
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Você verá que a execução para no lançamento da exceção no 
método DisparaETrataExcecao , ou seja, antes de ser tratada no 
bloco catch da instrução try...catch . Clique no botão 
Continue ou tecle F5 e observe que novamente a execução é 
interrompida com a sinalização de exceção lançada, desta vez no 
método DisparaExcecaoNaoTratada . Clicando em Continue 
uma vez mais, será exibido o aviso de exceção não tratada. 





Arquivo Editar Exibir Projeto Compilação Depurar Formatar Layout Teste Imagem | Pesquisar, P| Produhap > O x 
Análise Ferramentas Extensões Janela Ajuda 
©- md 9- P Continuar - F [8 nO SID Blvestre É 
-£ 
E 
[E ProdutividadeEmCSharp ~ L% ProdutividadeEmCSharp.Program -| 9 DisparaETrataExcecao() -|3 
1 using System; + È 
2 a 
3 Elnamespace ProdutividadeEmCsharp ms 
4 £ 
5 EI class Program È 
7 E public static void DisparaETrataExcecao() 
8 
9 E try 
10 { 
» iu Q 
12 + 
13 catch (Exception e) Exceção Lançada 1x Í 
14 { 
15 Console.wWriteLine($"Tratei a exceção! į System.AccessViolationException: 'Attempted to read or write i 
16 3 protected memory. This is often an indication that other memory is 
17 } corrupt. 
18 
e a public static void DisparsExcecaoNaoTratada() | pi Detalhes | Copiar Detalhes | Inicie a Sessão do Live Share. 
21 throw new AccessViclationException()3 4 Configurações de Exceção 
22 } [Ml Interromper quando esse tipo de exceção é lançado 
23 Exceto quando lançado de: 
C ProdutividadeEmCSharpall 
= a static void Main(string[] args) Abrir Configurações de Exceção | Editar Condições 
26 DisparaETrataExcecao(); 
27 DisparaExcecaoNaoTratada(); 
o 2z 
29 } 
30 
31 } 


100% ~ © Não foi encontrado nenhum problema | Y v Ln:11 Carl7 SPC CRLF 





ar ao Controle do Código-Fonte «Mg 


Figura 8.17: Execução interrompida com o lançamento da exceção do tipo 
AccessViolationException 


Repare na imagem anterior que através da própria janela de 
lançamento da exceção é possível abrir a janela Configurações de 
Exceção e editar a condição atual que rastreou a exceção. 


8.8 INTERROMPENDO A EXECUÇÃO QUANDO UMA EXCEÇÃO FOR GERADA 
235 


Para saber mais sobre a janela Configurações de Exceção e 


sobre filtragem por condição, consulte a seguinte página da 


documentação: 


https://docs.microsoft.com/pt- 
br/visualstudio/debugger/managing-exceptions-with-the- 
debugger?view=vs-2019 





8.9 CAPTURANDO EXCEÇÕES DO PRÓPRIO 
FRAMEWORK E DE BIBLIOTECAS DE 
TERCEIROS 


O Visual Studio possui um recurso de depuração pouco 
conhecido chamado Apenas meu código (em inglês, Just my Code), 
que está ativo por padrão para melhorar a experiência de 
depuração. Ele esconde da lista pilha de chamadas, as chamadas 
aos métodos do framework e aos métodos das bibliotecas de 
terceiros colocando em seu lugar uma linha marcada como 
[Código Externo]. Veja: 


Pilha de Chamadas 





Nome Linguagem Status do Quac 
| [Código Externo] I | Quadro com ..b 
© ProdutividadeEmCSharp.dll!ProdutividadeEmCSharp.Program.Main(string[] args = (string[0])Linha 22 C& Símbolos car... 


Figura 8.18: Janela Pilha de Chamadas exibindo apenas código de usuário 
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Esta abordagem simplifica o processo de depuração, 
permitindo que o desenvolvedor ou desenvolvedora se concentre 
em seu próprio código, e não no que foi gerado automaticamente 
ou desenvolvido por terceiros. Na documentação oficial, o código- 
fonte que geramos é chamado de Código de usuário. O restante é 
considerado como código não-usuário e inclui código gerado 
automaticamente pelos designers, como o código que inicializa um 
aplicativo ou coloca os controles nas janelas em aplicações 
Windows Forms e WPF, código de terceiros que incluímos na 
forma de pacotes via gerenciador de pacotes NuGet e o código do 
próprio framework. Até mesmo parte do seu código gerado, por 
exemplo, por uma ferramenta automática, pode entrar nessa 
classificação se for marcado com o atributo de código não-usuário 

DebuggerNonUsercode . Veja a seguir a janela Pilha de Chamadas 
mostrando código não-usuário para o mesmo programa: 


Pilha de Chamadas 





Nome Linguagem Status do Quac 






he... | Nenhum sim... 







t<Prod e... Nenhum sim 


© ProdutividadeEmCSharp.dil!ProdutividadeEmCSharp.Program.Main(string[] args = {string[0]})Linha 22 


ro> (string value 


Símbolos car... 


Figura 8.19: Janela Pilha de Chamadas exibindo métodos do código não-usuário (biblioteca 
de terceiros) 


Ao desativar o recurso Apenas meu código, você verá a pilha de 
chamadas completa, o que pode fornecer dicas para solucionar o 
problema. Com ele ativo, ainda é possível inspecionar essas 
informações extras, mas é necessário clicar com o botão direito do 
mouse sobre a janela e selecionar no menu de contexto a opção 
Exibir Código Externo. 


Quando este recurso está ligado, o Visual Studio interrompe a 
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execução apenas em exceções lançadas no seu próprio código. Sem 
que saibamos, muitas outras exceções são lançadas, sendo em sua 
maioria irrelevantes. Essas exceções ocorrem no próprio .NET 
framework e em bibliotecas de terceiros e geralmente não 
queremos ser notificados sobre elas. 


Em cenários nos quais comportamentos anormais estão 
acontecendo, entretanto, desativar temporariamente este recurso 
pode ser útil para que possamos analisar com mais detalhes estas 
exceções. Por exemplo: 


e Uma solicitação ao seu servidor retorna 500 sem motivo 
aparente. 

e Uma chamada ao código da biblioteca de terceiros retorna 
resultados inesperados. 

e Uma chamada ao código da biblioteca de terceiros gera 
uma exceção. 


Para desativar o recurso Apenas meu código, execute os 
seguintes passos: 


1. No menu Depurar, selecione Opções. 

2. A caixa de diálogo Opções será exibida com a opção Geral da 
depuração pré-selecionada. Na lista de opções mostrada à 
direita, desmarque a caixa de verificação Habilitar apenas 
Meu Código. Em seguida, clique no botão OK. 


Agora que você já sabe como ativar e desativar o recurso, 
vamos testá-lo com o código a seguir: 


using System; 
using Newtonsoft. Json; 


namespace ProdutividadeEmCSharp 
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class Livro 


{ 
public string Titulo { get; set; } 
public string Autor { get; set; } 
} 
class Program 
{ 
static void Main(string[] args) 
{ 
string json = @"{ 
'Titulo': 'Produtividade em C#', 
'Autor': 'Cláudio Ralha' 
3"; 
//json = "Que tal um café?"; 


Livro livro = JsonConvert.DeserializeObject<Livro>(js 
on); 

Console.wWriteLine($"Título: (livro.TituloJNAnAutor: {1 
ivro.Autor)");, 


Note que é necessário incluir o pacote Newtonsoft. Json 
usando o gerenciador de pacotes NuGet e incluir um ponto de 
interrupção na linha que efetua uma chamada ao método 
Deserializeobject da biblioteca. 


Rode a primeira vez com a linha que produzirá o erro 
comentado e observe que o código funciona como esperado. Veja: 





ES CAWINDOWSisystem32Acmd.exe — o x 


itulo: Produtividade em C& A 
utor: Cláudio Ralha 
ressione qualquer tecla para continuar. 





Figura 8.20: Funcionamento esperado do programa de teste 


8.9 CAPTURANDO EXCEÇÕES DO PRÓPRIO FRAMEWORK E DE BIBLIOTECAS 
DE TERCEIROS 239 


Em seguida, descomente a linha que criamos para forçar o 
lançamento da exceção e execute uma vez mais. Confira o 
resultado na próxima imagem: 
























DX] Arquivo Editor Exibir Projeto Compilação Depurar Teste Análise Ferramentas Extensões Janela Ajuda P Podhap — O x 
©- wut 9- > Continuar - 5 [8 . nO 31? Iĝ liveShare É 
CEEE -$ 

E 
[E] ProdutividadeEmCSharp ~% ProdutividadeEmCSharp.Program ~ 9a Main(stringl] args) -A 
1 [Eusing System; EI É 
2 [using Newtonsoft. Json; ae 
E) I g 
4 namespace ProdutividadeEmCSharp E ER $ 
5 If 
| E 7 Newtonsoft.Json.JsonReaderException: ‘Unexpected character 
e ie class [ERR encountered while parsing value: Q. Path ", line O, position 0: 
i | 
8 public string Titulo ( get; set; ) L 
eferê Esta exceção foi gerada originalmente nesta pilha de chamadas: + 
ê i ` A NewtonsoftJson.JsonTextReader.ParseValuel) 
E public string Autor | get; sets } NewtonsoftJson.JsonReader RescAndMoveToContentf) 
10 NewtonsoftJson JsonReader.ReadForType(Newtonsoft.Jsoi 
11 $ Newtonsoft Json Serialization JsonSerializerinternalReader. 
f rE NewtonsoftJson.JsonSerializer.Deserializeinternal(Newton 
Newtonsoft.Json.JsonSerializer.Deserialize(Newtonsoft.Jsor 
E Pi 
Es T CSRO Newtonsoft Json JsonConvert.DeserializeObject{string, Sys 
13 { Nawtanenft lenn IsonConvert DecarializaNhiart<T>letrino Y 
14 ` + 
| Exibir Detalhes | Copiar Detalhes | Inicie a Sessão do Live Share. 
15 E static void Main(string[] args) ai Configurações de Peri 
16 | { C interromper quando esse tipo de exceção é lançado 
17 - string json = @"{ Exceto quando lançado de: 
18 "Titulo": 'Produtividade em C#' NewtonsoftJsondl 
19 “Autor': "Cláudio Rolha’ Abrir Configurações de Exceção | Editar Condições 
2 || o 
21 json = “Que tal um café?"; 
© 2/41| Livro livro = JsonConvert.DeserializeObject<Livro>(json);| 63 
23 Console.Writeline($"Título: (livro-TituloFinAutor: (livro.Autor)"); 
24 ” 
121% ~ © Não foi encontrado nenhum problema Ie 4 La ln:22 Car13 SPC CRLF 
Pilha de Chamadas EER 
Nome Linguagem Status do Quadro 
© NewtonsoftJson.dIlINewtonsoft Json. Serialization JsonSerializerintemalReader Deserialize(Newtonsoft JsonJsonReader reader = NE Desconhecido Nenhum símbolo ca... 
Newtonsoft. rializer.Deserializelnternal(N JsonReader reader = (NewtonsoftJsonJsonTe Nenhum símb 
Newtoi nReader reader = (Newton: Nenhum símbolo 





Nenhum simb 
Nenhum símbi 





Nenhum simb 
OD ProditividadeEmCSharp.dilProdutividadeEmCSharp.Program Main(stringl] args = (tringlO]DLinha 22 ce Símbolos carregados. 








Figura 8.21: Exceção lançada em um método do código não-usuário 


Ao compararmos as duas visualizações da pilha de chamada, 
ficamos com a sensação de que antes estávamos aprendendo a 
andar de bicicleta com segurança e que agora nos tiraram as 
rodinhas. Com o tempo, você descobrirá que esse recurso é 
particularmente útil para testar novas versões de bibliotecas de 
terceiros e do próprio framework, ainda não estáveis. 
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Para saber mais sobre como trabalhar com o recurso Apenas 
meu código desabilitado, consulte: 


https://docs.microsoft.com/pt-br/visualstudio/debugger/just- 


my-code?view=vs-2019 


https://docs.microsoft.com/pt-br/visualstudio/debugger/how- 
to-use-the-call-stack-window?view=vs-2019 





8.10 CONSULTANDO A PSEUDOVARIÁVEL 
$EXCEPTION 


Durante a depuração do código, por vezes nos deparamos com 
um bloco catch genérico em uma estrutura try...catch que 
sequer possui uma variável a ser inspecionada. Veja o exemplo: 


static void Main(string[] ) 


int a = 10, b= 0, =0; 








Figura 8.22: Depurando o tratamento de uma exceção de um tipo desconhecido 


Neste ponto, surge aquela dúvida: o que fazer para ter acesso 
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aos detalhes da exceção lançada sem precisar fazer alterações no 
código e reexecutá-lo. A boa notícia é que o Visual Studio dispõe 
de várias pseudovariáveis usadas para os mais diversos fins e uma 
delas éa $exception que armazena a última exceção lançada. 


Você pode usar as janelas de Inspeção, Inspeção Rápida 
(QuickWatch) ou Imediata, que abordaremos em detalhes no 
capítulo sobre depuração, para inspecionar esta variável. Confira: 
































QuickWatch m| xX 
Sexception v 
Adicionar Inspeção 
Valor: 
Nome | Valor Tipo ^ 
3 ) $exception {"Attempted to divide by zero."} System. Divi... 
bp # Data {System.Collections.ListDictionarylnternal} System.Coll... 
# HResult | -2147352558 Lint 
# HelpLink_| null string 
b Æ InnerExce..] null = [System.Exce... 
Æ Message | "Attempted to divide by zero." Qv[string 
= A Serializati null OOOO = [string 
A Serializati...| "mê ProdutividadeEmCSharp.Program.Main(... Q~] string 
Ja Serializati...| null 5 E | object 
# Source "ProdutividadeFmCSharn" Q ~| strina x 





ud 


Figura 8.23: Consultando a pseudovariável $exception usando a janela de Inspeção Rápida 





Para conhecer a lista completa de pseudovariáveis suportadas 
pelo Visual Studio, acesse: 


https://docs.microsoft.com/pt- 
br/visualstudio/debugger/pseudovariables?view=vs-2019 
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8.11 CRIANDO CLASSES DE EXCEÇÃO 
PERSONALIZADAS 


O Visual Studio conta com um recurso chamado Geração a 
partir do Uso que nos permite criar automaticamente classes, 
structs, interfaces, enumerações e métodos a partir de uma 
referência do seu uso. Abordaremos esta funcionalidade em 
detalhes no próximo capítulo, mas antes veremos como utilizá-la 
para criar o esqueleto de uma classe que herda da classe 
Exception a partir do seu uso. Considere o exemplo a seguir: 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Teste() 
{ 
throw new MyCustomException(); 
3 
static void Main(string[] args) 
{ 
Teste(); 
3 
3 
3 


Para criar o código da classe MyCustomException usada no 
método Teste , basta parar com o mouse sobre a marca 
inteligente que é mostrada embaixo do nome e selecionar no menu 
a opção Gerar classe MycustomException em um novo arquivo. 
Veja: 
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Oreferências 
class Program 


1 referência 
static void Teste() 


throw new MyCustomException(); 
: ©- 
ferra ciass My aros option ni nes Ea [+] © c50246 O nome do tipo ou do namespace "MyCustomException" não pode ser 
Gerar class 'MyCustomException' uma diretiva using ou uma referência de assembly?) 
Oreferências 


static void Main; Gerar class 'MyCustomException' aninhado 








Adicionando “Mycustomexception.cs" a "ProdutividadeEnCSharp” com conteúdo: 


Gerar novo tipo... 
Teste(); 








Visualizar alterações 


Figura 8.24: Gerando de forma automática o esqueleto de código da classe 
MyCustomException 


Isso fará com que seja criado no projeto o arquivo 
MyCustomException.cs com o código mostrado a seguir: 


using System; 
using System.Runtime.Serialization; 


namespace ProdutividadeEmCSharp 


{ 


[Serializable] 
internal class MyCustomException : Exception 


{ 
public MyCustomException() 


{ 
} 


public MyCustomException(string message) : base(message) 
{ 
} 


public MyCustomException(string message, Exception innerE 
xception) : base(message, innerException) 


£ 


244 8.11 CRIANDO CLASSES DE EXCEÇÃO PERSONALIZADAS 


protected MyCustomException(SerializationInfo info, Strea 
mingContext context) : base(info, context) 


{ 
} 


Percebeu quanto trabalho esta ferramenta é capaz de poupar? 
Vale destacar, entretanto, que só devemos criar classes de exceção 
personalizadas quando as já existentes não atenderem aos nossos 
propósitos. Na maioria dos cenários, elas atendem, então "Não 
perca tempo reinventando a roda"! 


Neste capítulo, adiantamos alguns recursos relacionados à 
depuração que será tratada em detalhes mais adiante no capítulo 
11. Isso foi necessário para agrupar de forma sequencial o máximo 
de informações relevantes para o desenvolvedor que já domina o 
básico do tratamento de exceções. 


Antes de avançar para o próximo capítulo focado na geração 
de código, recomendamos a leitura da página a seguir que 
contém as melhores práticas para gerenciamento de exceções, 
reunidas pelo time de desenvolvimento do Visual Studio: 


https://docs.microsoft.com/pt- 


br/dotnet/standard/exceptions/best-practices-for-exceptions 
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CaríruLo 9 


GERAÇÃO DE CÓDIGO 


A geração automática de código é um assunto que atrai o 
interesse de todos os desenvolvedores que buscam produtividade e 
que faz parte do dia a dia inclusive daqueles que não percebem a 
sua presença. 


Desde a seleção de um template para um novo projeto no 
Visual Studio até a criação de um banco de dados usando um 
framework de mapeamento ORM, como Entity Framework Core, 
passando pela simples criação de um membro de classe usando um 
Code Snippet ou de um formulário usando um Designer, estamos 
fazendo uso da geração de código para minimizar o trabalho 
"braçal" e tedioso. São facilidades que tornam o Visual Studio mais 
amado e completo a cada release e que ainda podem ser estendidas 
através de extensões gratuitas e pagas disponíveis no Visual Studio 
Marketplace. 


Ao longo deste capítulo, veremos como explorar várias 
funcionalidades que nos pouparão muitas horas de trabalho e 
encantarão até os mais céticos. Iniciaremos o nosso estudo 
mostrando como usar fragmentos de dados nos formatos JSON e 
XML para criar de forma automática classes inteiras que possam 
armazená-los. 
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Abordaremos em sequência um recurso chamado Geração a 
partir do uso, que nos permite criar automaticamente classes, 
structs, interfaces, enumerações e métodos a partir de uma 
referência do seu uso. 


Em seguida, demonstraremos as várias formas de usar snippets 
de código, como baixar snippets extras e como criar os seus 
próprios snippets de código. Se você tem dificuldade para 
memorizar certas sintaxes complexas da linguagem, vai amar esse 
recurso e usá-lo sem moderação. 


O capítulo termina apresentando como baixar templates de 
projeto disponíveis on-line e como gerar os seus próprios templates 
de projeto. Você descobrirá nas próximas páginas que existe muita 
coisa boa e gratuita on-line esperando apenas o seu download. 


9.1 GERANDO CLASSES A PARTIR DE JSON E 
XML 


O Visual Studio dispõe de um gerador de classes a partir de 
dados fornecidos em JSON e XML. Para utilizá-lo, bastará copiar 
para o clipboard um trecho de código escrito em um desses dois 
formatos. No exemplo a seguir, temos um fragmento de código em 
JSON representando este livro: 

{ 


"Titulo": "Produtividade em C#", 
"Autor": "Cláudio Ralha", 

"Ano": 2021, 

"Editora": "Casa do Código" 


Após efetuar a cópia para a área de transferência, o processo de 
geração de código é bem simples. Basta clicar no menu Editar, 
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selecionar o submenu Colar especial e escolher a opção Colar JSON 
como classes ou a opção Colar XML como classes dependendo do 
formato dos dados selecionados. 


Veja o código gerado pelo Visual Studio para o JSON 
fornecido: 


public class Rootobject 


{ 
public string Titulo { get; set; } 
public string Autor { get; set; } 
public int Ano { get; set; } 
public string Editora { get; set; } 
3 


Observe que nesse caso o único ajuste que precisaremos fazer 
será renomear a classe de Rootobject para Livro . Pense em 
um JSON com cinquenta campos e você terá uma ideia imediata 
de quanto trabalho chato e cansativo esta ferramenta é capaz de 
nos poupar. 


9.2 GERANDO CLASSES E STRUCTS A PARTIR 
DO SEU USO 


A partir do Visual Studio 2015, a IDE passou a dispor de um 
recurso nativo de geração de código chamado Geração a partir do 
Uso (em inglês, Generate from Usage). Ele nos permite escrever um 
código que faça referência a classes, structs, interfaces, 
enumerações e membros que não existem e faz com que o 
ambiente de desenvolvimento os crie automaticamente. Isso é 
particularmente útil em alguns estilos de programação, como o 
TDD (Test-driven Development - Desenvolvimento orientado a 
testes). 
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Para ilustrar como criar o código de uma classe a partir do seu 
uso, vamos adicionar ao método Main de uma aplicação de 
console a linha de código a seguir: 


Pessoa pessoa = new Pessoa(); 


Como a classe Pessoa ainda não existe no projeto, ela estará 
sublinhada em vermelho no editor de código do Visual Studio. 
Para gerar a classe Pessoa com um mínimo de esforço, execute 
os seguintes passos: 


1. Clique com o botão direito do mouse sobre o nome da classe 
na linha anterior e selecione no menu de contexto a opção Ações 
Rápidas e Refatorações. Também é possível exibir esse menu 
parando o cursor de inserção sobre o nome Pessoa e teclando 
Ctrl + ponto final. Em ambos os casos, serão exibidas as opções 
mostradas na imagem a seguir: 


class Program 


static void Main(string[] ) 
Pessoa pessoa = new Pessoa(); 
MANAA ARRARAR 
; E 
} Gerar class 'Pessoa' no novo arquivol N + | © C5024656 O nome do tipo ou do namespace "Pessoa" não pode ser 


Gerar caso Pessoa encontrado (está faltando uma diretiva using ou uma referência de 
assembly?) 
Gerar class 'Pessoa' aninhado z == - 
Adicionando “Passos.cs” a “Produtividaderncsharp” com conteúdo 
Gerar novo tipo... namespace ProdutividadeEnCSharp 
i 
internal class Pessoa 
public pessos() 
í 
} 
, 
, 


Visualizar alterações 


Figura 9.1: Gerando uma classe a partir do seu uso 


2. Selecione a opção Gerar class “Pessoa” no novo arquivo. 


Pronto! O arquivo será gerado com o nome Pessoa.cs , mas 
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não será automaticamente carregado no editor de código para não 
atrapalhar a edição no arquivo em que estamos atualmente 
trabalhando. Abra-o e inspecione o código gerado. 


Uma segunda maneira de criar a classe é usando a smart tag ou 
marca inteligente mostrada junto ao erro. Para exibi-la, basta parar 
o mouse sobre o nome da classe sublinhado em vermelho. Clique 
na seta existente junto ao símbolo para exibir o menu visto 
anteriormente e selecionar a opção Gerar class “Pessoa” no novo 
arquivo. Veja: 
static void Main(stringl] ) 


{ 


Pessoa pessoa = new Pessoa(); 


} E N O nome do tipo ou do namespace "Pessoa" não pode ser encontrado (está faltando uma diretiva using ou uma referência de 
Š assembly?) 


Mostrar possíveis correções (Alt+ Enter ou Ctri+.) 


Figura 9.2: Utilizando a marca inteligente para acessar o menu de geração de código 


Caso prefira usar o teclado, pressione Ctrl+. para abrir as 
opções de marca inteligente. Saiba que é possível utilizar essa 
combinação de teclas logo depois de digitar o nome da classe, 
evitando o mouse durante toda a operação. 


É importante destacar que parte dos elementos que vamos criar 
usando esta funcionalidade serão apenas stubs, ou seja, membros 
sem código real criados apenas para permitir a compilação. Eles 
serão modificados posteriormente pelo desenvolvedor para 
adicionar a funcionalidade necessária. O recurso "Gerar a partir do 
uso" nos permite criar stubs para classes, estruturas, interfaces, 
métodos, propriedades, campos, enumerações e constantes de 
enumeração. 


Ao examinar o código da classe Pessoa que acabamos de 
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criar, você notará que ela é gerada no namespace padrão do 
projeto e inclui as diretivas de uso que estão presentes para uma 
classe criada manualmente. 


Caso deseje ter mais controle sobre a classe criada ou criar um 
struct, utilize o comando Gerar novo tipo no menu da marca 
inteligente. A caixa de diálogo Gerar Tipo será exibida: 





Gerar Tipo ? x 


Detalhes do Tipo: 
Acessar: Tipo: Nome: 


Default ” class E Pessoa 


Local: 





Projeto: 
ProdutividadeEmCSharp x 
Nome do Arquivo: 


D Criar novo arquivo 


Pessoa.cs 





(e) Adicionar ao arquivo existente 
«Current File> v 





OK Cancelar 

















Figura 9.3: Construindo o tipo a partir da caixa de diálogo Gerar Tipo 


Ao examinar esta janela, observe a lista suspensa Tipo. Ela 
especifica o tipo de código a ser criado (classe ou struct). Em 
Acessar, podemos escolher o modificador de acesso entre 
internal e public . Na lista de projetos, caso exista mais de um 
na solução, podemos escolher ao qual desejamos adicionar o 
código. Isso é útil para o TDD quando os testes são mantidos em 
um projeto separado do código da aplicação. 
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9.3 GERANDO PROPRIEDADES E CAMPOS A 
PARTIR DO SEU USO 


As propriedades e campos podem ser gerados de maneira 
semelhante aos tipos. Se você adicionar o código a seguir, o 
membro Nome será sublinhado: 

Pessoa pessoa = new Pessoa(); 
pessoa.Nome = "Cláudio Ralha"; 

Como esse membro não inclui parênteses, ele representa uma 
propriedade ou campo indefinido. Siga o mesmo procedimento 
descrito na seção anterior para ativar a marca inteligente e você 
verá o menu mostrado na imagem a seguir: 





static void Main(string[] ) 
Pessoa pessoa = new Pessoa(); 
pessoa.Nome = “Cláudio Ralha”"; 
Gerar propriedade PessoaNome j» © © C51051 'Pessoa' não contém uma definição para "Nome" e não foi 
Gerar campo 'Pessoa.Nome' possível encontrar nenhum método de extensão "Nome" que aceite um 


primeiro argumento do tipo 'Pessoa' (você está se esquecendo de usar u... 
} 
public string Nome { get; internal set; } 


} 


Visualizar alterações 


Figura 9.4: Gerando uma propriedade a partir do seu uso 


Selecione a opção Gerar propriedade Pessoa. Nome”. O código a 
seguir será adicionado à classe Pessoa : 
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ZEEE Program.cs 














c&) ProdutividadeEmCSharp -| fig ProdutividadeEmCSharp.Pessoa 
1 =Jhamespace ProdutividadeEmCSharp 
2 { 
3 = public class Pessoa 
4 { 
5 = public Pessoa() 
6 { 
7 } 
8 
9 public string Nome { get; internal set; } 
10 } 
11 } 


Figura 9.5: Inspecionando a propriedade Nome gerada 


Observe que o tipo de dados é inferido do código. Em muitos 
casos, esse tipo estará correto. Em algumas poucas exceções, será 
necessário alterá-lo. 


9.4 GERANDO MÉTODOS A PARTIR DO SEU 
USO 


Para gerar um stub de um método, seja ele um método de 
instância ou um método estático, basta adicionar um membro 
indefinido com parênteses ou parâmetros. Adicione o seguinte 
código ao programa para testar esse recurso: 


pessoa.Escrever("Produtividade em C\#"); 


Utilize a marca inteligente para gerar o método através da 
opção Gerar método 'Pessoa.Escrever' conforme explicado 
anteriormente. Confira na próxima listagem o código gerado para 
o método Escrever : 
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internal void Escrever(string v) 


{ 


throw new NotImplementedException(); 


Observe que o tipo de retorno do método foi especificado 
corretamente e que você provavelmente vai querer alterar a 
visibilidade do método alterando o modificador de acesso de 
internal para public . O mesmo pode ocorrer com o nome 
dos parâmetros. 


Com relação ao nome dos parâmetros, se você utilizar variáveis 
como parâmetros no momento de criar o stub, os seus nomes 
serão utilizados para nomear os parâmetros. Para testar, adicione 
as seguintes linhas de código ao método Main da classe 
Program.cs : 
string mensagem = "Produtividade em CH"; 


ConsoleColor cor = ConsoleColor.Green; 
pessoa.Escrever (mensagem, cor); 


Gere código para esta sobrecarga do método Escrever 
Confira a seguir o código gerado pelo Visual Studio: 


internal void Escrever(string mensagem, ConsoleColor cor) 


{ 


throw new NotImplementedException(); 


Outra forma de se obter o mesmo resultado é usando 
parâmetros nomeados. Veja um exemplo: 


pessoa.Escrever (mensagem: "Produtividade em C#", cor: ConsoleColo 
r.Green); 


Ao criar as sobrecargas do método Escrever , observe que o 
Visual Studio oferece também a opção de adicionar o parâmetro 
cor ao método existente. Veja: 
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static void Main(string[] ) 

{ 
Pessoa pessoa = new Pessoa(); 
pessoa.Nome = “Cláudio Ralha"; 
pessoa.Escrever("Produtividade em C&"); 
string mensagem = “Produtividade em C&”; 
ConsoleColor cor = ConsoleColor.Green; 
pessoa.Escrever(mensagem, cor); 

} é 


Adicionar parâmetro so. u © CS1501 Nenhuma sobrecarga para o método "Escrever" leva 2 
Gerar método 'Pessoa.Escrever' argumentos 





internal void Escrever(string v 
internal void Escrever (string yi, ConsoleColor co 
í 


Visualizar alterações 


Figura 9.6: O gerador de código oferece a opção de adicionar parâmetro ao método 
previamente criado 


Um detalhe importante a ser notado ao gerar stubs de método 
é o de que o uso da palavra-chave var impede a detecção do tipo 
correto de retorno para o método. Para ilustrar, gere um stub para 
o método ECasado da linha de código a seguir: 


var casado = pessoa.ECasado(); 


Ao inspecionar o código gerado pelo Visual Studio, você verá 
que o uso da palavra-chave var fez com que o gerador colocasse 
como retorno object em vez de bool . Altere o tipo de retorno 
do método gerado ECasado para bool ou repita o procedimento 
partindo da linha de código a seguir: 


bool casado = pessoa.ECasado(); 


9.5 GERANDO CONSTRUTORES A PARTIR DO 
SEU USO 


A ferramenta de geração de código a partir do seu uso é um 
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aliado poderoso na busca por produtividade. Até agora, já vimos 
como criar classes, propriedades, campos e métodos. Vamos 
explorar mais um pouco esse recurso criando construtores. 


Para criar um construtor parametrizado (o construtor padrão é 
gerado junto com a classe), basta partir de uma linha de código, 
como a mostrada a seguir, e utilizar a opção Generate Constructor 
in Pessoa': 


Pessoa autor = new Pessoa(nome:"Cláudio Ralha"); 
Confira o código gerado para o construtor: 


public Pessoa(string nome) 


{ 


Nome = nome; 


Voilà! O construtor gerado para a classe Pessoa atribui o 
parâmetro nome à propriedade Nome conforme esperado. 


9.6 GERANDO ENUMERADOS A PARTIR DO 
SEU USO 


Para finalizarmos o nosso tour sobre a geração de código a 
partir do seu uso no Visual Studio, vamos falar sobre o uso desta 
ferramenta com tipos enumerados. Ela só permite a adição de uma 
constante de enumeração, ou seja, é necessário que tenhamos 
criado previamente o tipo enumerado, ainda que vazio. Em outras 
palavras, se você já definiu um enum, você pode escrever código 
que contém referências a membros de enum indefinidos e usar o 
menu Gerar ou a marca inteligente para adicionar a constante à 
enumeração. A constante é adicionada como um novo item sem 
valor explícito. 
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Como exemplo, vamos criar um tipo enumerado chamado 

eEstadocivil . Por questão de simplicidade, adicione-o no 

próprio arquivo Pessoa.cs . Defina-o como mostrado no 
fragmento de código a seguir: 


public enum eEstadoCivil 


{ 
Solteiro, 
Casado 


Obviamente, faltam estados nesse tipo enumerado. Na classe 
Pessoa , inclua a declaração da propriedade EstadoCivil : 


public eEstadoCivil EstadoCivil { get; set; } 


De volta ao arquivo Program.cs , adicione a seguinte linha de 
código: 


autor .EstadoCivil = eEstadoCivil.Divorciado; 


Utilize a marca inteligente para selecionar a opção Gerar 
membro enum 'eEstadoCivil.Divorciado’. Veja: 


static void Main(string[] ) 
{ 


Pessoa autor = new Pessoa(nome: “Cláudio Ralha"); 


} % 
Gerar membro enum Atadocivi Dior] (9 cson17 "eEstadoCivil" não contém uma definição para 'Divorciado" 


Solteiro, 
Casado 
Casado] 


} 


Visualizar alterações 


Figura 9.7: Adicionando o membro Divorciado ao tipo enumerado eEstadoCivil 


Inspecione novamente o tipo enumerado e confira que a 
constante enumerada Divorciado foi adicionada. 
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public enum eEstadoCivil 


{ 
Solteiro, 
Casado, 
Divorciado 
} 


São recursos como este que aumentam a nossa capacidade de 
gerar uma grande quantidade de códigos com qualidade em um 
tempo reduzido, minimizando o trabalho braçal e fazendo com 
que sobre mais tempo para que a pessoa desenvolvedora pense no 
que está realmente fazendo. 


Para saber mais sobre a geração de código a partir do seu uso, 
visite a seguinte página da documentação oficial: 


https://docs.microsoft.com/pt- 


br/visualstudio/ide/walkthrough-test-first-support-with-the- 
generate-from-usage-feature?view=vs-2019 





9.7 USANDO SNIPPETS DE CÓDIGO EM SEUS 
PROJETOS 


Code snippets são pequenos fragmentos de código que 
podemos inserir em um arquivo de código no Visual Studio 
usando um atalho (em inglês, shortcut), como ctor seguido de 
Tab duas vezes ou usando o menu de contexto. 


A lista de snippets disponíveis depende do tipo de arquivo em 
edição. Ao editarmos um arquivo .cs , teremos disponíveis os 
code snippets do C# que acompanham o Visual Studio e outros 
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instalados a partir do Visual Studio Marketplace ou desenvolvidos 


pelo próprio desenvolvedor. 


Para obter snippets de código extras para o Cf, execute os 


seguintes passos: 


l. 


Acesse o endereço do Visual Studio Marketplace: 
https://marketplace.visualstudio.com/ 


Pesquise por code snippets. Uma lista de resultados será 
exibida incluindo snippets de código para outras linguagens 
e frameworks. Antes de avançar, perceba quantos snippets 
úteis estão disponíveis para poupar o nosso trabalho. Para 
usar os que estão marcados como FREE (gratuito), basta 
clicar no snippet desejado para exibir a página com uma 
descrição detalhada sobre ele. Experimente selecionar o item 
C# Methods Code Snippets criado por J. Sakamoto. 


Clique no botão Download. Será efetuado o download de um 
arquivo de extensão do Visual Studio( .vsix ). Abra-o para 
iniciar o instalador e clique no botão Install para efetuar a 
instalação. 


Ao final você verá uma mensagem de sucesso e um aviso 
pedindo para fechar e reabrir o Visual Studio, caso ele esteja 
aberto, para que as mudanças tenham efeito. 


Abra o Visual Studio e crie um projeto do tipo aplicação de 
console em C# para testar os novos snippets de código. 


Acesse novamente a página do snippet de código no Visual 
Studio Marketplace e leia a seção How to use? na qual estão 
enumerados os atalhos de teclado disponíveis para os code 
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snippets que acabamos de instalar. 


O uso de snippets de código acelera em muito a nossa 
produtividade, pois evita que tenhamos que memorizar sintaxes 
cada vez mais complexas para novas funcionalidades inseridas pelo 
time de desenvolvimento no C%. 


Ao longo de quase todos os capítulos deste livro, você deve ter 
observado que apresentamos snippets de código que acompanham 
o Visual Studio para inserir os tipos de construções que estão 
sendo tratados. Nesta seção, veremos as maneiras disponíveis para 
inserir os snippets em nosso código. 


Para ilustrar a primeira forma, baseada em um atalho de 
teclado, vamos utilizar o snippet de código de inserção de um 
método de instância sem parâmetros que faz parte do pacote que 
instalamos na seção anterior. Execute o seguinte roteiro: 


1. Abra um arquivo de código em C# do projeto, como, por 
exemplo, Program.cs e digite method seguido de Tab. Veja que 
durante a digitação, o IntelliSense do Visual Studio lista os 
snippets de código que contêm a sequência de letras digitadas: 


class Program 














method 
CEE pb ethos 
method! Code snippet for a public method 
method? Observação: pressione Tab duas vezes para inserir o snippet 'method'. 
method3 








é res) 
fg MethodAccessException 


iz MissingMethodException 
a RuntimeMethodHandle 


+ tg r mM 


Figura 9.8: IntelliSense exibindo a lista de atalhos para os code snippets 
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2. Após a digitação do Tab, o código é inserido no lugar da 
palavra de atalho: 


class Program 


{ 
public void MyMethod() 
{ 
throw new NotImplementedException(); 
} 


Figura 9.9: Código do método inserido via code snippet 


3. Perceba que o modificador de acesso public está 
selecionado. Você pode digitar um modificador de acesso 
diferente, como private ou simplesmente teclar Tab para 
avançar para o retorno do método e trocá-lo de void para 

string , por exemplo, e, em seguida, teclar Tab novamente para 

selecionar e alterar o nome do método de MyMethod para algo 
significativo. Ao final, tecle Esc para tirar a seleção das partes da 
assinatura do método. 


Note que, apesar de ser extremamente prática, esta forma de 
trabalhar exige que saibamos de antemão o atalho. O que fazer 
quando não conseguirmos lembrar o que digitar para inserir o 
snippet de código? 


Para esses casos, temos algumas opções: 
a. Procurar neste livro ou no Google. 


b. Usar a inserção de snippets de código via menu de contexto 
que mostraremos a seguir. 
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c. Clicar no menu Ferramentas e selecionar a opção 
Gerenciador de Snippets de Código. Através desta ferramenta é 
possível inspecionar todos os snippets de código instalados. 


Basta selecionar a linguagem C# em Linguagens e as categorias 
de snippets disponíveis serão exibidas no painel à esquerda. 
Expanda as categorias para inspecionar os snippets. Na imagem 
anterior, methods corresponde à categoria instalada pelo pacote 
que baixamos do Visual Studio Marketplace nesta seção. Ao 
navegar pelas listas de snippets de código, note que o caminho para 
o snippet selecionado é mostrado no campo Local: 





Gerenciador de Snippets de Código ? xX 
Linguagem: 
CSharp v 


Local: 
c\users\claudio\appdata\local\microsoft\visualstudio\16.0_320a9cbd\extensions\krd3lbox.grq\csharp\methc 











v “=| methods A | Descrição 
[] async method Code snippet for an async method 
[] static method o lp====== 
[.1 async static metho! eres 5 


1 
i 
i 
| extension method EEE, 


| extension method with one argument Tipos de snippets 


„| extension method with three arguments Expansion 
extension method with two arguments 


| event handler 





























[1] public method rop 
[] public method with one argument 
[1] public method with three arguments 
[1 public method with two arguments 
Ml mentir minant hanrdlar 
< > 
Adicionar... Remover 
Importar... Cancelar 
Figura 9.10: Descobrindo o atalho para o snippet desejado usando o Gerenciador de Snippets 
de Código 


A segunda forma de inserir um snippet é clicando com o botão 
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direito do mouse sobre o editor de código em um arquivo de 
código C#, selecionar no menu de contexto o submenu Snippets e, 
a seguir, a opção Inserir Snippet. Veja: 


8 - class Program 





9 { 
a 1 Executar o Código Selecionado 
12 9 Ações Rápidas e Refatorações... Ctrl+. 
13 Renomear... F2 
14 Remover e Classificar Usos Ctrl+R, Ctrl+G 
E inspecionar Definição Alt+F12 
15 - “a Ir para Definição F12 ) 
16 Ir Para Implementação Ctri+F12 
17 | Localizar Todas as Referências Ctrl+K, R 
18 m Exibir Hierarquia de Chamada Ctrl+K, Ctrl+T 
19 Criar Testes de Unidade 
20 Ponto de interrupção é 
k Executar até o Cursor Ctrl+ FIO 
Executar em Interativo Ctrl+E, Ctrl+E 
Snippet + “7 Envolver com... Ctri+K, S 
X Recortar Ctrl+X t1 Inserir Snippet... N Ctri+K, X 
(ml Copiar Ctrl+C Inserir Comentário 
É) Colar Ctrl+V 
Anotação > 
Estrutura de Tópicos + 





Figura 9.11: Acessando o menu de inserção de Snippets 


Isso fará com que seja exibido o menu de inserção de snippets 
de código mostrado na próxima imagem. Você também pode 
exibi-lo diretamente teclando Ctrl + K X. 


Para selecionar a categoria desejada, use o mouse ou as setas de 
teclado. A tecla Tab expande a categoria selecionada e insere o 
snippet. 
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feré 
8 -= class Program 





9 { 
10 -i Inserir Snippet: methods | 
11 gk! extension method a 
T2 gk! extension method with one argument 
13 3® extension method with three arguments 
14 9E! extension method with two arguments 
hane Sd gk! public method 
5 Wl public method with one argument 
z E ge POE g 
= Maini z z 

15 static void Mai sk! public method with three arguments 
16 E { 9&! public method with two arguments 
1. Code snippet for a public method with one argument g€! static event handler z 
14 Atalho: method] 
19 } 


Figura 9.12: Menu de inserção de Snippets 


Com o que vimos até aqui já é possível poupar muito trabalho, 
mas saiba que os snippets de código ainda nos permitem ir além. 
Em muitos cenários, temos um bloco de código que gostaríamos 
de mover para dentro de: 


e um laço como for ou while; 
e uma instrução condicional if ; 
e uma instrução using; 


e uma instrução try...catch e outras possibilidades. 


Para lidar com esses casos, basta selecionar o código a ser 
envolvido pelo snippet e teclar Ctrl+K S ou clicar com o botão 
direito do mouse sobre o código e selecionar no menu de contexto 
o submenu Snippet e a seguir a opção Envolver com snippet. Veja: 
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oo 
LU 


9 t 








t1 Envolver com... 
tI Inserir Snippet... 


Inserir Comentário 


O referências 
class Program 


O referências 


static void Main(string[] ares) 


{ 


//Código que pode disparar uma exceção 


Ctri+K, S 
Ctrl+K, X 


E o 


m* jaj 


m 








Executar o Código Selecionado 
Ações Rápidas e Refatorações... 
Renomear... 

Remover e Classificar Usos 
Inspecionar Definição 

Ir para Definição 

Ir Para Implementação 
Localizar Todas as Referências 
Exibir Hierarquia de Chamada 
Criar Testes de Unidade 

Ponto de interrupção 

Executar até o Cursor 

Executar em Interativo 

Snippet 

Recortar 

Copiar 

Colar 


Anotação 


Estrutura de Tópicos 


Ctrl+. 

F2 

Ctrl+R, Ctrl+G 
Alt+F12 

F12 

Ctrl+F12 
Ctrl+K, R 
Ctrl=K, Ctrl+T 


Ctrl+F1O 
Ctrl+E, Ctrl+E 


Ctrl+X 
Ctrl+C 
Ctrl+V 


Figura 9.13: Acessando o menu de inserção de Snippets 


No menu de snippets de código, selecione a opção desejada. 


Para esse teste, escolha try : 
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O referências 
8 = class Program 
{ 
O referências 
10 pn static void Main(string[] args) 
11 { 
12 
13 //Código que pode disparar uma exceção 
14 Envolver com: | 
15 s 88 lock a 
16 } E! namespace 
17 $ gk! struct 
Snippet de código para try catch ge CE 
Atalho: try ge tyf 
ge! unchecked 
ge! unsafe 
ge! using 
ge while v 


Figura 9.14: Usando a opção Envolver com para aplicar o snippet Try...catch 


O código do snippet será adicionado. Repare que o bloco de 
código que envolvemos foi colocado dentro do try : 


O referências 
8 4 class Program 
9 t 

O referências 

10 k static void Main(string[] args) 
11 { 
12 
13 = try 
14 { 
15 //Código que pode disparar uma exceção 
16 
17 } 
184 catch (ExCEpESON) 
19 { 
20 
21 throw; 
22 } 
23 J 
24 } 
25 |) 





Figura 9.15: Snippet da estrutura try...catch adicionado 
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9.8 CRIANDO OS SEUS PRÓPRIOS SNIPPETS 
DE CÓDIGO 


Podemos criar os nossos próprios snippets de código 
reutilizável para o Visual Studio. 


Os snippets são arquivos com a extensão .snippet escritos 
em linguagem XML que podem ser editados no próprio Visual 
Studio. Veja a seguir o código do snippet criado para inserir 
Console.wWriteline() usando o atalho cw : 












[Ef CAProgram Files (86) Microsoft Visual Studio\2019\Community\VC#\ Snippets\1046\Visual C#\cw.snippet - Notepad++ o x 
Arquivo Editar Localizar Visualizar Formatar Linguagem Configurações Tools Macro Executar Plugins Janela ? x 
BHeGSGBlshB|2claa|224|Ba|=1EBBDES|S BI E| 
<?xml version="1.0" encoding="utf-8"?> 

2 [<CodeSnippets xmins="http://schemas .microsoft.com/VisualStudio/2005/CodeSnippet"> 

3 a <CodeSnippet Format="1.0.0"> 

o B <Header> 

9 i 

7 <Description>Snippet de código para Console.WriteLine</Description> 

8 <Author>Microsoft Corporation</Author> 

9 Ð <SnippetTypes> 

10 [<SnippetType>Expansion</SnippetType> | 

1 Or o 

12 </Header> 

13 g <Snippet> 

14 g <Declarations> 

15 A <Literal Editable="false"> 

16 <ID>SystemConsole</ID> 

17 <Function>SimpleTypeName(global: : System. Console)</Function> 

18 | </Literal> 

So | Pet a Eis SD 
29 E | <Code Language="csharp"><| [CDATA[SSystemConsoles .liriteLine($end$);1]> 1 
21 | </Code> 1 
1 CO sa Y 
23 </CodeSnippet> 





24 -</CodeSnippets> 











eXtensible Markup Language file length: 755 lines: 25 Ln:1 Col:1 Sel:0]0 Windows (CRLF) UTF-8 INS 





Figura 9.16: Inspecionando o código do snippet usado para inserir Console. Writeline() 


É possível editar o XML diretamente no editor de código do 
Visual Studio ou em um programa similar, como o bom e velho 
Notepad++, mas isto exigiria um conhecimento maior da sua parte 
sobre a estrutura do XML que precisa ser gerada. 
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Como alternativa para simplificar o nosso trabalho e 
aumentar a nossa produtividade, é recomendável utilizar uma 


extensão, como o Snippet Designer, que oferece suporte visual 


para a construção dos snippets. Ela está disponível em: 


https://marketplace.visualstudio.com/items?itemName=vs- 
publisher-2795.SnippetDesigner 





Baixe-a e instale-a da mesma forma como fizemos com o 
pacote de snippets de métodos. 


Com a extensão instalada, podemos criar um novo snippet do 
zero em Cé executando os seguintes passos: 


1. No menu Arquivo, selecione o submenu Novo e a seguir a 
opção Arquivo.... A caixa de diálogo Novo Arquivo será 
exibida. 


2. Clique no item Snippet Designer do painel à esquerda. Em 
seguida, selecione o template Code snippet listado no painel 
central. Clique no botão Abrir para iniciar o designer de 
snippets. 


3. O designer de code snippets será exibido. Veja: 


268 9.8 CRIANDO OS SEUS PRÓPRIOS SNIPPETS DE CÓDIGO 


DX) Arquivo Editar Exibir Projeto Compilação Depurar Teste Análise Ferramentas Extensões Janela Ajuda | Pesquisar (Ctri+Q) P Podhp — O x 




















0-0 8-% ad 9-C- Debug - AnyCPU ~. P ProdutividadeEmCSharp ~ Ë Iĝ liveShare 
Snip E Pessoa Program.cs = Propriedades “x 
Snippet: Snippetfilel ~ Language C# |>| Shortcut: Snippet: Snippetfilet 











a m] 
= aN 





seuawesa] aP exe 


Nome do snippet Linguagem em uso atālho 


Código do snippet é editado nesta área 





iSnippet Kind MethodBody 


isoppethpe. Ego) 


As propriedades do snippet 
são editadas nesta área 


133% ~ © Não foi encontrado nenhum problema 


[o Top — Defautato Kind Type Functon Edtable — 





Alternative Shortcuts 
Collection of alternative shortcuts used for 
executing the snippet 





Figura 9.17: Tela principal do designer de code snippets 


Para ilustrar como usar o designer, vamos criar um snippet que 
insira Console.Writeline com uma string interpolada. Para 
tanto, execute os seguintes passos: 


1. No campo Snippet, digite cwti. 
2. Em Language, selecione C%. O default é C++. 
3. No campo Shortcut, digite novamente cwti. 


4. No editor de propriedades, altere a propriedade Author para 
o seu nome e a propriedade Description para Snippet para 
Console.wWriteLine com texto interpolado . Como o código 
que vamos inserir faz uso do caractere $ , normalmente usado 
como delimitador de parâmetros substituíveis, altere a propriedade 
Replacement Delimiter de $ para # . Veja: 
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Propriedades 








Snippet: cwti X 
p] 4 
Alternative Shortcuts (Coleção) 
Author Cláudio Ralha 
Description Snippet para Console.WriteLine com texto interpolado 
File Path C:\Users\Claudio\Documents\Visual Studio 2019%\Code Snippet: 
Help Url 
Imports (Coleção) 
Keywords 
References (Coleção) 
: 
Shortcut cwti 
Snippet Kind MethodBody 
Snippet Type Expansion 


Figura 9.18: Alterando o delimitador padrão de parâmetros substituíveis 


5. Na área reservada para a edição do snippet, entre com o 
seguinte código: 


Console.writeLine($"#texto#"); 


6. A linha anterior fará com que o parâmetro de substituição 
texto seja criado. No campo Tooltip da linha referente ao 
parâmetro, altere o conteúdo da coluna de Texto para Texto a 


ser inserido. 


7. Tecle Ctrl + s para salvar o snippet. Ele será criado com o 
nome atribuído no campo Snippet. Os snippets que você criar em 
C# no visual Studio 2019 ficarão armazenados por padrão na 
seguinte pasta do seu computador: 

%USERPROFILE%\Documents\Visual Studio 2019\Code 
Snippets\Visual C#\My Code Snippets 


Com o arquivo já salvo, alterne para um arquivo em C# no 
editor, como Program.cs , e digite cwti dentro do método 
main . Veja: 
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class Program 














static void Main(string[] args) 
cul. 
} cw 
} C 7 
S] m Snippet para Console.WriteLine com texto interpolado 
ta Observação: pressione Tab duas vezes para inserir o snippet 'cwti'. 


Figura 9.19: Digitando o atalho cwti para o snippet 


Ao teclar Tab, o atalho será substituído pelo código a seguir. 
Note que a string texto está pré-selecionada e será substituída 
pelo texto digitado pelo desenvolvedor: 


class Program 


{ 
static void Main(string[] ) 
{ 
Console.WriteLine($" EB"); 
} 
} 


Figura 9.20: Código gerado via snippet 


Ao construirmos nossos próprios snippets, temos a liberdade 
de criá-los de forma que sejam capazes de: 


e Importar automaticamente os namespaces necessários. 

e Suportar as operações de inserção do código do snippet e 
de envolver o código existente. 

e Sinalizar em que parte do código eles podem ser inseridos. 

e Permitir a substituição de parâmetros. 


Um estudo completo sobre a criação de snippets foge ao 
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escopo deste livro, mas saiba que esta é uma excelente forma de 
organizar trechos reaproveitáveis do seu código e compartilhá-los 
com outros desenvolvedores. É possível inclusive iniciar a criação 
de snippet usando o Snippet Designer a partir de um trecho de 
código selecionado no editor. Basta clicar com o botão direito do 
mouse sobre o texto selecionado e escolher no menu de contexto a 
opção Export as Snippet. Veja: 


eferências 


8 = class Program 

9 { 
10 = static void Main(string[] args) 
11 { 
12.4 Console.WriteLine($"texto"); 
13 Executar o Código Selecionado 
14 Ações Rápidas e Refatorações... Ctrl+. 
15 + Renomear... F2 

Remover e Classificar Usos Ctrl+R, Ctrl+G 


Export as Snippet N 


E inspecionar Definição Alt+F12 

Ta Ir para Definição F12 
Ir Para Implementação Ctrl+Fi2 
Localizar Todas as Referências Ctrl+K, R 

Fa Exibir Hierarquia de Chamada Ctrl+K, Ctrl+T 
Criar Testes de Unidade 
Ponto de interrupção b 

k Executar até o Cursor Ctrl+F1O 
Executar em Interativo Ctrl+E, Ctrl+ E 
Snippet + 

X Recortar Ctrl+X 

ó! Copiar Ctrl+C 

É) Colar Ctrl+V 
Anotação > 
Estrutura de Tópicos > 





Figura 9.21: Exportando um trecho de código no editor como snippet 
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A forma mais rápida de aprender a criar snippets de código 
mais avançados é inspecionando o código de snippets existentes, 
alterando-os conforme a sua necessidade e salvando-os com um 
novo nome e atalho de teclado atribuído. 


Para visualizar a lista de arquivos de snippets para a linguagem 
C& que acompanham o Visual Studio 2019, acesse a seguinte pasta: 


C:\Program Files (x86)\Microsoft Visual 
Studio\2019\Community\VC#\Snippets\1046 


Para saber mais sobre a criação de snippets de código, 
incluindo como utilizar parâmetros de substituição e realizar 
importação de namespaces, consulte: 


https://docs.microsoft.com/pt- 


br/visualstudio/ide/walkthrough-creating-a-code-snippet? 


view=vs-2019 





9.9 DOCUMENTANDO O CÓDIGO-FONTE 
COM COMENTÁRIOS XML 


Ter à disposição documentação confiável para orientar o nosso 
trabalho é algo vital quando precisamos dar suporte a vários 
sistemas ao mesmo tempo. A presença de documentação do 
código facilita a evolução, manutenções corretivas e transferência 
de conhecimento para outros desenvolvedores. 


Uma das formas disponíveis para efetuar a documentação do 
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código é usando comentários e documentação XML. Os 
comentários XML são um tipo especial de comentário que 
adicionamos acima da definição de qualquer tipo ou membro 
definido pelo usuário. Assim como ocorre com outros tipos de 
comentários, os comentários de documentação XML também são 
ignorados pelo compilador. 


O compilador se limita a processar esses comentários em 
tempo de compilação, gerando ao final um arquivo de 
documentação XML que pode ser distribuído junto ao seu 
assembly .NET ou .NET Core. Esse arquivo permite que o Visual 
Studio use o IntelliSense para mostrar informações rápidas sobre 
tipos ou membros. 


Arquivos de comentários XML também podem ser usados por 
ferramentas, como Swagger, DocFX, GhostDoc e Sandcastle para 
gerar sites de referência de API. 


Para ativar a geração do arquivo de documentação XML, 
execute os seguintes passos: 


1. Clique com o botão direito do mouse sobre o nome do 
projeto no Gerenciador de Soluções e selecione Propriedades. 


2. A página de propriedades do projeto será exibida. Selecione 
a guia Compilar e ative a caixa de verificação Arquivo de 
documentação XML. Observe que você também pode alterar o 
local no qual o compilador grava o arquivo se desejar. 
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DE] Arquivo Editar Exibir Projeto Compilação Depurar Teste Análise Ferramentas Extensões Janela Ajuda Pesquisar. P Produhap — O X 





o- B-S ME 9- Debug ~ Any CPU | ProdutividadeEmCSharp - P [6] = IB liveShare É 
2 EEE -ê 
S Aplicativo $ 
7 Configuração: | Ativo (Debug) v| Plataforma: | Ativo (Any CPU) X 2 
E! Compilar* a 
3 a i 
È Eventos de Compilação Geral e lis 
* Pacoti § 

éra Símbolos de compilação condicional: | ] $ 
Depurar = == 

[C Definir constante DEBUG 7 

Assinatı 8 

nro Definir constante TRACE H 

Análise de Código S 

Destino da plataforma: Any CPU X = 


Recursos 
[C Preferir 32 bits 


[C Permitir código não seguro 
[ Otimizar código 


Erros e avisos 


Nível de aviso: 4 X 





Suprimir avisos: 1701;1702 





Tratar avisos como erros 
O Nenhum 
O Todos 
(O) Avisos específicos: (NU1605 








Saída 





Procurar... 

















1 [[SharplProdutividadeEmCSharp'ProdutividadeEmCSharpaemf N 


E Local em que o arquivo é gerado 


Gerar assembly de serialização: Auto X 





Figura 9.22: Ativando a geração do arquivo de documentação XML de um projeto no Visual 
Studio 


3. Tecle Ctrl + s ou clique no botão Salvar da barra de botões 
do Visual Studio para efetivar a alteração. Feche, a seguir, a página 
de propriedades. 


Para incluir comentários de documentação XML em seu 
código, basta parar com o cursor de inserção do editor de código 
na linha acima do tipo ou membro que deseja documentar e 
digitar barras triplas ( /// ). Exemplo: 
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-“jnamespace ProdutividadeEmCSharp 


É 


Solteiro, 
Fonda Da 
Casado, 
A 
Divorciado; 
Viuvo 


E public class Pessoa 


{ 9 =|| dg class ProdutividadeEmCSharp.Pessoa 


pub lic Pessoa ( Comentário XML ausente para tipo publicamente visível ou membro "Pessoa" 


{ Mostrar possíveis correções (Alt+ Enter ou Ctrl+.) 


} 


E public Pessoa(string nome) 


public string Nome { get; internal set; } 
public eEstadoCivil EstadoCivil { get; set; } 


Figura 9.23: Comentário XML para um tipo preenchido pelo desenvolvedor 


Conforme você pode observar, os comentários da 
documentação XML usam barras triplas e um corpo de comentário 
no formato XML. As tags que vão compor o XML gerado 
dependerão do tipo de elemento que está sendo documentado e se 
ele possui parâmetros. Veja na próxima imagem o esqueleto de 
documentação gerado pelo Visual Studio para um método: 
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//[ <summary> 

[11 

//[ </summary> 

//[ <param name="“mensagem"></param> 

//! <param name="cor"></param> 

1 referência 

public static void Escrever(string mensagem, ConsoleColor cor) 
{ 


throw new NotImplementedException(); 


} 


Figura 9.24: Esqueleto de comentário XML para um método 


E, a seguir, a documentação XML já preenchida pelo 


desenvolvedor: 


/// <summary> 

/// Método estático para escrever uma mensagem colorida no Console. 

//L </summary> 

/// <param name="mensagem">Mensagem a ser exibida.</param> 

/// <param name="cor">Cor a ser usada na mensagem. A cor é representada 
//{/ por uma constante do tipo enumerado System.ConsoleColor.</param> 


1 referência 
public static void Escrever(string mensagem, ConsoleColor cor) 


{ 


throw new NotImplementedException(); 


} 


Figura 9.25: Comentário XML para um método preenchido pelo desenvolvedor 


Ao usarmos o método Escrever em nosso código, veremos a 


documentação sendo exibida como tooltip. Observe: 


O referências 


static void Main(string[] args) 


{ 


Escrever ("Produtividade em C&",; 


void Program.Escrever(string mensagem, ConsoleColor cor) 
Método estático para escrever uma mensagem colorida no Console. 
cor: Cora ser usada na mensagem. À cor é representada por uma constante do tipo enumerado System.ConsoleColor. 


Figura 9.26: Documentação XML sendo exibida para o método Escrever 


E o melhor de tudo é que se mudarmos a assinatura do 
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método, adicionando, por exemplo, um parâmetro extra, seremos 
lembrados pelo Visual Studio de que é preciso atualizar a 
documentação XML. Observe: 


//[ <summary> 

/// Método estático para escrever uma mensagem colorida no Console. 

/// </summary> 

/// <param name="mensagem">Mensagem a ser exibida.</param> 

//[ <param name="cor">Cor a ser usada na mensagem. A cor é representada 
/// por uma constante do tipo enumerado System.ConsoleColor.</param> 


ferência 
public static void Escrever(string mensagem, ConsoleColor cor, bool piscari 
{ RE) aeee e 


throw new NotImplementedExcept: 
Parâmetro "piscar" não tem tag param correspondente no comentário XML para "Program.Escrever(string, 


y ConsoleColor, bool)" (mas outros parâmetros têm) 


Mostrar possíveis correções (Alt+ Enter ou Ctrl+.) 


Figura 9.27: Sinalização de documentação XML desatualizada 


Para solucionar o problema, clique em Mostrar possíveis 
correções e selecione no menu de contexto a opção Adicionar nós 
de parâmetro ausentes. Isso fará com que seja gerado uma tag para 
o parâmetro piscar que falta ser documentado. Veja: 


//[ <summary> 

/// Método estático para escrever uma mensagem colorida no Console. 

f} </summary> 

//[ <param name="mensagem">Mensagem a ser exibida.</param> 

/// <param name="cor">Cor a ser usada na mensagem. A cor é representada 
//[ por uma constante do tipo enumerado System.ConsoleColor.</param> 


Pato (A de asda mi ar aos pi danada o aan E 
i /// <param name="piscar"></param> ! 


public static void Escrever(string mensagem, ConsoleColor cor, bool piscar) 


{ 


throw new NotImplementedException(); 


} 


Figura 9.28: Incluindo o parâmetro ausente na documentação XML 


Um efeito colateral da ativação dos comentários XML é que o 
Visual Studio passará a sinalizar todo o código C# do seu projeto 
que não contém comentários. Veja: 
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-“jnamespace ProdutividadeEmCSharp 


É 


E public enum eEstadoCivil 


Solteiro, 
Solteiro 
Casado, 
Casado 
Divorciado, 


E public class Pessoa 


{ 9 =]| dg cass ProdutividadeEmCSharp.Pessoa 


public Pessoa( Comentário XML ausente para tipo publicamente visível ou membro "Pessoa" 


{ Mostrar possíveis correções (Alt+ Enter ou Ctrl+.) 


} 


public string Nome { get; internal set; } 
public eEstadoCivil EstadoCivil { get; set; } 


Figura 9.29: Sinalização de comentário XML ausente para um tipo 


Isso obviamente é algo irritante e indesejável para a maioria 
dos desenvolvedores. Para desativar esse aviso, volte novamente à 
guia Compilar da página de propriedades do projeto, adicione o 
número 1591 no campo Suprimir aviso da seção Erros e avisos e 
salve o projeto. Caso já exista outro número neste campo, separe 
os dois números usando o caractere de ponto e vírgula. 


Agora que você já tem o seu projeto devidamente configurado, 
já pode iniciar a documentação usando comentários XML. Estão 
disponíveis por default as seguintes tags: <c> , <para> , <see>, 

<code>, <param> , <seealso> , <example> , <paramref> , 


<summary> , <exception> , <permission> , <typeparam> , 
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<include> , <remarks> ,  <typeparamref> , <list> , 


<returns> e <value>. 


Não nos aprofundaremos aqui no uso de cada uma dessas 
tags pois o nosso objetivo é apenas mostrar o caminho a ser 
trilhado. Você encontrará a documentação detalhada de cada 
tag a partir da lista disponível na seguinte página da 
documentação oficial: 


https://docs.microsoft.com/pt- 
br/dotnet/csharp/programming- 
guide/xmldoc/recommended-tags-for-documentation- 
comments 


Para saber mais sobre documentação de código XML acesse 
também a seguinte página: 


https://docs.microsoft.com/pt- 
br/dotnet/csharp/programming-guide/xmldoc/ 


As ferramentas externas de geração de documentação 
mencionadas nesta seção estão disponíveis em: 


DocFx: https://dotnet.github.io/docfx/ 
GhostDoc: https://submain.com/products/ghostdoc.aspx 


SandCastle: 


https://www.microsoft.com/download/details.aspx?id=10526 


Swagger: https://swagger.io/ 
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Vale destacar que algumas ferramentas, como o SandCastle 
oferecem suporte a tags extras como <event> e <note> . Nada 
impede que você também defina suas próprias tags, desde que elas 
sejam reconhecidas pelo programa que escolher para processar o 
XML gerado. 


9.10 BAIXANDO TEMPLATES DE PROJETO 
DO VISUAL STUDIO MARKETPLACE 


O Visual Studio é uma IDE extremamente poderosa e 
extensível. Graças à sua arquitetura modulável, é possível adicionar 
suporte a um grande número de linguagens e frameworks e baixar 
novos templates de projetos e pacotes para a linguagem desejada à 
medida que se tornarem necessários. Dentre outras vantagens, isso 
reduz o tempo e o espaço em disco necessário para a instalação do 
Visual Studio. 


O conjunto inicial de templates de projeto de C& que 
acompanha o Visual Studio foi projetado para ser de uso geral, o 
que significa que parte deles oferece apenas o código inicial 
necessário para se começar a trabalhar. Não há como negar que 
esse esqueleto inicial já poupará muito trabalho, mas haverá 
cenários em que você desejará ir além e partir de um modelo de 
projeto mais elaborado que ofereça recursos avançados, como, por 
exemplo, suporte a log e autenticação. Nesses casos, é possível 
recorrer a templates criados por outros membros da comunidade e 
disponibilizados em sites, como o Visual Studio Marketplace ou o 
GitHub. 


Nesta seção, veremos como baixar novos templates para o C& 
no Visual Studio Marketplace. Note que podemos fazer a busca 
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diretamente no site de forma semelhante à que fizemos com os 
snippets de código ou pesquisar os templates on-line por dentro do 
próprio Visual Studio. 


Esta segunda alternativa é a mais produtiva, pois nos permite 
filtrar os resultados com maior facilidade e acessar a página do 
template quando for conveniente. Para comprovar, basta executar 
os seguintes passos: 


1. No menu Extensões selecione a opção Gerenciar extensões. 


2. A caixa de diálogo Gerenciar extensões será exibida. Utilize a 
caixa de pesquisa localizada na parte superior direita para 
procurar uma palavra-chave como, por exemplo, a palavra 

bot ou navegue pelo painel da esquerda até Online > Visual 
Studio Marketplace > Modelos > Visual C& e, a seguir, clique 
em uma das categorias de projetos disponíveis. 


3. Selecione a extensão ou o template desejado. Clique no botão 
Baixar que será exibido. Após a instalação ser concluída, 
você verá um símbolo de check à direita do template 
instalado. Repare que no painel da direita é possível carregar 
a página web do template clicando em Mais informações. 
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Gerenciar Extensões ? x 
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A ra a Templates for Microsoft Bot Framework vá, Will let — Criado por: BE Microsoft 
Atas E you quickly create a bot that uses core Al capabiliti.. Versão: 462 
'ontroles E Microsoft Downloads: 76175 
b Ferramentas Categoria de Preços: Gratuito 
4 Modelos <> Enterprise Bot Template Classificação: d+ (25 Votos) 
b Other temas bot scenarios using the Bot Builder ESPE 
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14 Visual CE i scean 
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SALES, Virtual Assistant Template 


jendado para Instalação: 
Project template for advanced bot scenarios using the Bot Builder Ag m E 


Nenhum 
jendado para Atual 3 
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b Gerenciador de Extensão de Roamin <y S templo E à 
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Alterar as configurações das Extensões 


Go | 








Figura 9.30: Pesquisando on-line novos templates para o Visual Studio 


Clique no botão Fechar para encerrar a ferramenta de 
gerenciamento de extensões. 


Uma vez instalado o novo template ou conjunto de templates, 


já poderemos usá-lo. Basta executar o seguinte roteiro: 


1. Clique no menu Arquivo e selecione Novo Projeto. 
2. A caixa de diálogo Novo Projeto será exibida. Para este 


exemplo, vamos pesquisar no campo de busca a palavra- 
chave bot para localizar todos os templates que possuam 
esta palavra em seus nomes. 

Selecione o template desejado e clique em Próximo. A 
sequência de passos a partir deste ponto dependerá do tipo 
de projeto escolhido. 
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9.11 CRIANDO OS SEUS PRÓPRIOS 
TEMPLATES DE PROJETO 


Ao trabalharmos no desenvolvimento de múltiplos sistemas, 
por vezes acabamos criando códigos que precisam estar presentes 
em vários projetos. Para lidar com esse tipo de problema, muitos 
desenvolvedores simplesmente copiam e colam o código de um 
projeto em outro, o que acaba gerando vários problemas ao longo 
do tempo. 


Obviamente, o Visual Studio oferece maneiras mais 
inteligentes de encapsular e reutilizar o código previamente 
desenvolvido. Vejamos: 


a) No caso de um projeto que represente o código inicial para 
novos desenvolvimentos, podemos gerar um novo template de 
projeto que ficará disponível posteriormente a partir da caixa de 
diálogo Novo Projeto do Visual Studio. Exemplo: um projeto em 
Angular 8 com código de back-end em C# (Web API) e referências 
para as principais bibliotecas necessárias, folhas de estilo em SASS, 
logo da empresa, componentes comuns (login, trocar senha, 
esqueci minha senha) etc. 


b) No caso de uma biblioteca de classes, podemos gerar um 
pacote NuGet que poderá tanto ser tornado público quanto ser 
mantido privado para uso apenas na empresa. 


A criação de um novo template de projeto a partir de um 
projeto existente é uma tarefa simples. Para simular esse cenário, 
execute os seguintes passos: 


1. Crie um novo projeto do tipo aplicação de console em .NET 
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Core com o nome de AppConsoleTemporizador . 


2. Altere o código do arquivo Program.cs conforme a 
listagem a seguir: 


using System; 
using System.Diagnostics; 
using System.Threading; 


namespace AppConsoleTemporizador 


{ 


class Program 


{ 


static void Main(string[] args) 


{ 
Stopwatch stopwatch = new Stopwatch(); 
//Inicia cronômetro 
stopwatch.Start(); 


//Código cujo tempo de execução desejamos medir 
for (int i = 0, i < 10; i++) 
{ 

Thread.Sleep(1000); 


} 


//Para cronômetro 
stopwatch.Stop(); 


//Tempo em horas, minutos e segundos 
Console.writeLine("Tempo decorrido: {0:hh\\:mm\\:ss}" 
, stopwatch.Elapsed); 


} 
} 


Com esta mudança já temos o necessário para ilustrar a criação 
de um template. Se desejar, adicione um novo arquivo ao projeto, 
como um arquivo texto leiame.txt , para testar essa 
possibilidade. 
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Para criar o template, execute os seguintes passos: 
1. No menu Projeto, selecione a opção Exportar Modelo. 


2. O Assistente de Exportação de Modelo será exibido. A opção 
Modelo de projeto desejada já está selecionada por default. 
Clique no botão Avançar. 





Assistente de Exportação de Modelo ? x 


pza Escolher Tipo de Modelo 


Este assistente permite exportar um projeto ou item de projeto da solução atual para um modelo que poderá servir de base 
para futuros projetos. 
Que tipo de modelo você deseja criar? 
@ Modelo de projeto 
Um modelo de projeto permite que um usuário crie um novo projeto com base no projeto exportado. Um usuário será 
capaz de utilizar o modelo a partir da caixa de diálogo Novo Projeto para projetos do cliente e da caixa de diálogo Novo 
Site para sites. 
O Modelo de item 


Um modelo de item permite que um usuário adicione o item a um de seus projetos existentes. O modelo estará disponível 
para o usuário na caixa de diálogo Adicionar Novo Item. 


De qual projeto você deseja criar um modelo? 


AppConsoleTemporizador 











Figura 9.31: Assistente de Exportação de Modelo - Passo 1 


3. No segundo passo, podemos fornecer um nome, descrição e 
ícone para o template. No campo Nome do modelo, digite 
Aplicativo de Console .NET Core com Temporizador. 
No campo Descrição do modelo, digite aplicação que 
utiliza a classe Stopwatch para medir o tempo de 
execução de um bloco de código . Note que é possível 
fornecer um arquivo de imagem como ícone para o projeto. 
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4. Mantenha selecionada a opção Importar automaticamente o 
modelo para o Visual Studio. Observe que o campo Local de 
saída informa a pasta em que o template exportado será 
gravado como um arquivo compactado no formato .zip: 


%USERPROFILE%\Documents\Visual Studio 2019\My 
Exported Templates\ 


Se você mantiver selecionada a opção Exibir uma janela do 
gerenciador na pasta de arquivos de saída, ao final da exportação o 
Explorador de Arquivos do Windows será carregado e exibirá a 
pasta que contém o template exportado, permitindo que você 
copie o template para outras máquinas. 


Note que o Visual Studio utiliza internamente outra pasta para 
manter os templates criados pelo desenvolvedor, localizada em: 


%USERPROFILE%\Documents\Documents\Visual Studio 
2019\Templates\ProjectTemplates 


Ao inspecionar esta pasta, você verá que existe uma estrutura 
de subpastas preparada para separar os templates por linguagens. 
Curiosamente, em nossos testes todos os templates foram criados 
diretamente na pasta ProjectTemplates . 


Clique no botão Concluir para confirmar a criação do template. 
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Assistente de Exportação de Modelo ? x 


bz Selecionar Opções de Modelo 


Nome do modelo: 





Aplicativo de Console .NET Core com Temporizador 





Descrição do modelo: 








Aplicação que utiliza a classe Stopwatch para medir o tempo de execução de um bloco de código. 





Imagem do Icone: 





CAUsersiClaudiotPictureslogo.png || Procurar... 





Visualizar Imagem: 





CAUsersiClaudiotPicturesogo.png || Procurar... 





Local de saída: 





-AUsersiClaudioiDocumentshVisual Studio 2019\My Exported TemplatestAplicativo de Console .NET Core com Temporizador.zip 











|] Importar automaticamente o modelo para o Visual Studio 














[V] Exibir uma janela do gerenciador na pasta de arquivos de saída 





< Voltar Cancelar 














Figura 9.32: Assistente de Exportação de Modelo - Passo 2 


Saiba que existem várias limitações no exportador de templates 
e na janela de criação de projetos que podem já ter sido resolvidas 
no momento em que você estiver lendo esta seção. No exportador 
de templates, faltam campos importantes que nos obrigam a 
descompactar o arquivo .zip, editar manualmente o arquivo de 
configuração MyTemplete.vstemplate para corrigir algumas 
configurações ausentes na interface gráfica como o 
<DefaultName> e recompactar o template, se quisermos obter 
resultados mais profissionais. 


O sistema de filtros e de tagueamento da caixa de diálogo Novo 
Projeto do Visual Studio 2019 ainda não funciona com os 
templates de projeto criados pelo desenvolvedor, o que significa 
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que teremos que procurar manualmente na lista pelo template que 
criamos com todos os filtros desligados. Confira o template que 
acabamos de criar na imagem a seguir: 





Criar um novo projeto  ssqisrmes 


Modelos de projeto recentes Todos os idiomas - Todas as plataformas - Todos os tipos de projeto ~ 


ge 
Aplicativo do Console (NET Core) = Gj Aplicativo Android XAML (Xamarin.Forms) 
Ò Um projeto para um aplicativo Android que usa Xamarin.Forms e XAML para criar a 
interface do usuário. 
Console App Boilerplate (.NET Core) 


E Aplicativo iOS XAML (Xamarin.Forms) 


“D Aplicativo Web ASP.NET Core c Um projeto para um aplicativo iOS que usa Xamarin.Forms e XAML para criar a 
interface do usuário 
E Biblioteca de Classes (NET Framework) c - : - a , 
Aplicativo de Console .NET Core com Temporizador 
Aplicação que utiliza a classe Stopwatch dir o tempo dı ão d 
AE UC ET g Rico iza a classe Stopwatch para medir o tempo de execução de um 
Biblioteca de Classes (NET E 
Mn Visual Basic [ES Extensão do Provedor de Arquivos de Documento (iOS) 


LE uma extensão de aplicativo de provedor de arquivos de seletor de documento. 


fin] Projeto de Teste de Unidade (.NET œ 


Framewori [ES Extensão de Bloqueador de Conteúdo (iOS) 
: SL Este modelo cria uma extensão de aplicativo de Bloguesdor de Conteúdo do Safari. 
EE) Aplicativo Web ASP.NET (NET Framework) c4 (A extensão e o aplicativo devem ser somente 64 bits) 
Aj ASP. «NET + 3 
pasa dae Visual Basic Gi Extensão de Hoje (105) 


Uma extensão de aplicativo de widget de hoje. 
Aplicativo do Console (NET Framework)  C# 
[TS* Extensão do iMessage (iOS) 
EMO Cria uma extensão do iMessage, o que permite que você apresente uma interface do 


Voltar Próximo X 


Figura 9.33: Caixa de diálogo Novo projeto exibindo o template de aplicação de console com 
temporizador 





Para saber mais sobre a criação de templates de projeto para o 


Visual Studio 2019, acesse a seguinte página da 
documentação oficial: 


https://docs.microsoft.com/pt-br/visualstudio/ide/how-to- 
create-project-templates?view=vs-2019 
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A geração de código é um assunto extremamente vasto e em 
constante evolução. Neste capítulo, falamos sobre a criação 
automática de tipos e membros baseada em seu uso, a geração de 
classes a partir de dados em JSON e XML e a criação e uso de 
snippets de código e templates de projetos. 


Nosso objetivo ao apresentar essas ferramentas foi o de 
despertar o seu interesse para o tema sem a pretensão de esgotá-lo. 
Reserve um tempo para pesquisar em fóruns, artigos e postagens 
de blogs quais são as melhores extensões, snippets de código, 
pacotes NuGet e templates de projeto disponíveis para simplificar 
o seu trabalho, pois quanto mais você procurar, mais opções 
interessantes pode descobrir. 


Quem já trabalha com frameworks como o Angular, sabe que a 
ferramenta de linha de comando Angular CLI usada pelos 
desenvolvedores, gera cerca de metade de todo o código-fonte de 
um projeto de forma automática durante a sua construção. 
Conforme você já deve imaginar, isso poupa um esforço 
considerável e libera mais tempo para pesquisarmos no Stack 
Overflow quando algo não sai como esperávamos! :) 
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CaríruLo 10 


LIMPEZA DE CÓDIGO- 
FONTE 


O Visual Studio 2019 simplifica o trabalho de reescrita do 
código legado fornecendo analisadores de código, um conjunto de 
regras de estilo de código para C# que podem ser versionadas e 
aplicadas a cada projeto em particular, ações rápidas, ferramentas 
de refatoração, ferramentas de limpeza de código e ferramentas de 
relatório de métricas de código. 


Neste capítulo, veremos como configurar e exportar para 
arquivos .editconfig as regras de estilo de codificação que serão 
utilizadas pelos analisadores de código, pelas ações rápidas e pela 
ferramenta de limpeza de código. Abordaremos em seguida como 
configurar e efetuar a limpeza automática de código-fonte e como 
consultar as métricas de código geradas. 


No final do capítulo, ainda explicamos como estender as 
funcionalidades dos analisadores de código e de ações rápidas e 
refatorações que abordaremos no próximo capítulo por meio de 
extensões gratuitas e pagas disponíveis no mercado. Para ilustrar o 
uso dessas extensões, demonstramos como instalar a extensão 
gratuita Roslynator, que acrescenta mais de 500 ações rápidas e 
refatorações ao Visual Studio. 
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Não se preocupe se tudo isso parecer novidade para você. 
Iniciaremos explicando todos os conceitos e ferramentas a serem 
utilizadas e em seguida passaremos à parte prática. Você verá que 
as funcionalidades que descreveremos serão empregadas de forma 
automática e imediata, no tempo de um estalar de dedos. 


Tenha em mente que garantir a qualidade do código que está 
sendo produzido é um dever de todo mundo que desenvolve, pois 
o nosso código ainda é o nosso melhor cartão de visitas! 


10.1 ENTENDENDO | ANALISADORES, 
CORREÇÕES DE CÓDIGO E REFATORAÇÕES 


Existem três conceitos básicos na análise de código que 
precisam ser entendidos para que possamos melhorar a qualidade 
do código de um projeto: analisador de código, correção de código e 
refatoração. 


O analisador é executado no Visual Studio em segundo plano e 
ele analisa o código-fonte à medida que este vai sendo construído. 
Quando encontra um trecho de código que não está em 
conformidade com uma regra que precisa ser seguida (estilo de 
código), o analisador reporta um diagnóstico. O diagnóstico é 
exibido na IDE através de sublinhados no editor de código e na 
janela Lista de erros e pode ser corrigido de forma automática pelo 
desenvolvedor, se houver disponível uma correção de código (em 
inglês, code fix). As correções de código aplicáveis são mostradas 
no topo do menu que é exibido quando selecionamos no menu de 
contexto a opção Ações Rápidas e Refatorações, pois elas têm 
precedência sobre as refatorações. Os diagnósticos marcados como 
ocultos não são visíveis como rabiscos no editor de código. 
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Vale destacar que algumas correções de código podem fornecer 
a opção Corrigir todas as ocorrências em, que permite aplicar a 
mesma correção em múltiplos locais (documento atual, projeto e 
solução). Veja: 














7 z static void Main( ] ) 
8 £ 
9 string titulo = "Produtividade em C#"; 
10 
110 += if (titulo != null && titulo != "") 
17 qe a 
4 Use 'string.lsNullOrEmpty' method N P | @ RCS1113 Use 'string.IsNullOrEmpty' method. 
z Invert operator 
Format binary expression on multiple lines O 
1º if (titulo != null && titulo != "") —— 
16 Replace 'titulo != null! with “string lsNullOrEmpty(titulo)' if (!string.IsNullorEmpty(titulo)) 
43 Replace 'titulo != null! with 'Istring.IsNullOrWhiteSpace(titulo)' { 
Introduzir o local » o 


Inverter If EFE a sao ca ca Sat 


Encapsulara expressão GRE GRR Ea GEES aaa S aa Soa so aa sons nmn 


Configurar ou Suprimir problemas + 


Figura 10.1: Opção para aplicar a mesma correção de código em múltiplos locais 


A refatoração representa uma única operação fornecida sob 
demanda, como extrair método. Quando solicitada, o Visual Studio 
sugere uma lista de refatorações aplicáveis a um determinado 
intervalo do código. 


Em termos práticos, você não precisa saber a diferença entre 
correções de código e refatorações para utilizá-las, especialmente 
porque as opções disponíveis são listadas no mesmo menu. A 
título de curiosidade, saiba que o Visual Studio as exibe de forma 
ligeiramente diferente. A correção de código é apresentada com 
um identificador e uma descrição no menu suspenso e também 
inclui o item Suprimir na parte inferior do menu de contexto. As 
refatorações são exibidas sem um identificador e descrição no 
menu suspenso. 
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10.2 IMPONDO REGRAS DE ESTILO DE 
CÓDIGO AOS PROJETOS 


O Visual Studio é um ambiente de desenvolvimento altamente 
customizável e nos permite controlar de forma detalhada as 
convenções de estilo de código que desejamos empregar no 
código-fonte dos projetos. Essas regras são usadas para definir 
como os códigos das ações rápidas e da limpeza de código que 
veremos a seguir serão gerados. 


Para acessar as configurações de estilo de código aplicáveis a 
projetos em Cf, clique no menu Ferramentas e selecione Opções. A 
caixa de diálogo Opções será exibida. Navegue para as 
configurações de estilo de código em Editor de texto > C& > Estilo 
de código. 




















Opções if x 
Opções de Pesquisa (Ctrl+E pe] O arquivo .editorconfig pode substituir as configurações locais definidas nesta página que se 
aplicam somente ao seu computador. Para definir que essas configurações se desloquem com a 
b Ambiente A sua solução, use arquivos EditorConfig. Mais informações Saiba mais 
Projeti Soluçõ 
: ES aa Gerar o arquivo .editorconfig das configurações 
b Itens de Trabalho Descrição Preferência Gravidade 
4 Editor de Texto E E 
“Preferências de 'this.': 
Geral à 
Avançado TTN Esse cano Não preferir ‘this’, ~ | O Somente Refa ~ 
Extensão do Argia Qualificar acesso da propriedade 
b SER ensaia! Não preferir 'this'. = | O Somente Refa ~ 
4 cë ss a 
Gaa meri Pn Não preferir ‘this’. ~| O Somente Refa ~ 
Barras 2 Rolagem Qualificar acesso do evento com Não preferir 'this'. v | O Somente Refa ~ 
Tabulações this 
Avançado Preferências de tipo predefinidas: 
4 Estilo do Código 
Geral capacity = 0; 


b Formatação 
Nomenclatura 

IntelliSense 
Ca LSP 
Ca LSP 
C/C++ 
css 
Dockerfile 
Fë 
HAI pé 


7vyvvvvv 














OK | Cancelar 


Figura 10.2: Opções de configurações de estilo de código para projetos em Cé 
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Basta configurar as colunas Preferência e Gravidade para cada 
item do grid conforme as suas necessidades e clicar em seguida no 
botão Ok para efetivar a mudança. A Gravidade pode ser definida 
como Somente Refatoração, Sugestão, Aviso ou Erro. Para habilitar 
Ações Rápidas para um estilo de código, verifique se a configuração 
de Gravidade está definida como algo diferente de Somente 
Refatoração. 


Note que dessa forma as configurações de estilo de código 
valerão apenas para a sua conta de personalização do Visual 
Studio, o que não é desejável quando estamos trabalhando em 
equipe. 


Felizmente, o Visual Studio também suporta o uso de um 
arquivo .editorconfig contendo as convenções de codificação 
que serão aplicadas ao código-fonte de um projeto específico. Essa 
alternativa permite que as configurações de estilo de código sejam 
versionadas, partilhadas com outros desenvolvedores e 
reaproveitadas em projetos futuros. 


Há várias formas de gerar o arquivo .editorconfig . A 
primeira é clicando com o botão direito do mouse sobre o nome 
do projeto no Gerenciador de Soluções e selecionando no menu de 
contexto o submenu Adicionar e, a seguir, a opção Novo Item. Na 
caixa de diálogo Adicionar Novo Item que será exibida, pesquise 
por editorconfig . Selecione qualquer um dos modelos de item 
de Arquivo editorconfig e clique no botão Adicionar. 


A segunda maneira de gerar um arquivo .editorconfig é 
usando a caixa de diálogo Opções do Visual Studio. Navegue para 
as configurações de estilo de código em Editor de texto > C& > 
Estilo de código. Configure as opções de estilo de código conforme 
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desejado e a seguir clique no botão Gerar o arquivo .editorconfig 
das configurações. A caixa de diálogo Salvar arquivo será exibida. 
Clique no botão Salvar para gravar o arquivo. Em seguida, clique 
no botão OK para fechar a caixa de diálogo Opções. Esta é a forma 
mais rápida e produtiva de se gerar o arquivo do zero. 


Uma terceira maneira de se adicionar o arquivo de 
configuração de estilos é importar um arquivo .editorconfig 
previamente criado para um projeto anterior. Experimente 
carregar o arquivo .editorconfig no editor de código do Visual 
Studio e verá que ele não contém nada que o vincule ao projeto em 
si, apenas configurações de estilo. 


10.3 EXECUTANDO LIMPEZA DE CÓDIGO 


As opções de configuração de estilo que configuramos na seção 
anterior podem ser aplicadas no código em C# usando os 
comandos Limpeza de código do Visual Studio 2019 e Formatar 
documento do Visual Studio 2017. 


A limpeza de código formata seu arquivo ajustando detalhes 
como a indentação e a remoção de espaços extras no final de uma 
linha. Aplica também os estilos de código definidos no arquivo 

EditorConfig , caso tenha sido criado um para o projeto ou as 
configurações de estilo de código disponíveis na caixa de diálogo 
Opções. 


Para realizar a limpeza de código no Visual Studio 2019 de um 
arquivo de código específico, clique no ícone de vassoura na parte 
inferior do editor ou pressione Ctrl+K, Ctrl+E. Veja: 
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121% ~ © Não foi encontrado nenhum problema E 


Figura 10.3: Botão de limpeza de código no Visual Studio 2019 


Ao clicar na seta existente ao lado do botão de limpeza, você 
verá que é possível alternar entre dois perfis diferentes de limpeza e 
também acessar as opções de configuração: 


y Executar Limpeza de Código (Perfil 1) Ctrl+K, Ctrl+E 
Executar Limpeza de Código (Perfil 2) 






& Configurar a Limpeza de Código 


121% ~ © Não foi encontrado nenhum problema Ir 


Figura 10.4: Acessando o menu de opções do botão de limpeza de código no Visual Studio 
2019 


À esquerda do botão de limpeza, temos uma outra novidade do 
Visual Studio 2019, o indicador de saúde do documento. Ele 
informa se não foi encontrado nenhum problema no documento 
atual, como no caso da imagem anterior, ou se foram encontrados 
erros e alertas, como no caso da próxima: 


Figura 10.5: Aviso de erros e alertas no código 


Nesse caso, é possível usar as setas para navegar entre os erros 
sinalizados ou clicar sobre o ícone de erros para carregar a janela 
Lista de Erros. 
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Na maioria dos casos, você vai desejar fazer a limpeza de 
código em todo o projeto ou em toda a solução. Para tanto, clique 
com o botão direito do mouse no nome do projeto ou no da 
solução no Gerenciador de Soluções, selecione o submenu Análise e 
Limpeza de Código e, a seguir, a opção Executar Limpeza de Código 
(Perfil 1). Veja: 


- | Di Main(stringl] args) e 








pP- 


ili luçãc 
Compilar Solução m6 ; tividadeEmCSharp 


Recompilar Solução 


Ee 


Limpar Solução 
Executar Análise de Código na Solução Alt+F11 Análise e Limpeza de Código E 
Compilar e Suprimir Problemas Ativos Compilação em Lotes... 


& Executar Limpeza de Código (Peril 1) Gerenciador de Configurações. 


Executar Limpeza de Código (Perfil 2) Bi Gerenciar Pacotes do NuGet para a Solução... 


TB) Restaurar Pacotes NuGet 
EF Configurar a Limpeza de Código 


sapepaudosg sag5eHoN s30Ínjos ap Jopenuasas 


EE] Novo Modo de Exibição do Gerenciador de Soluções 
Calcular Métricas de Código 
Adicionar 


ti Adicionar ao Controle do Código-Fonte... 


Renomear 

Œ@ Abrir Pasta no Gerenciador de Arquivos 
Salvar Como Filtro de Solução 
Ocultar Projetos Descarregados 
Carregar Dependências do Projeto 


Æ Propriedades Alt+ Enter 








Figura 10.6: Executando limpeza de código em toda a solução 


Para que a limpeza de código seja o mais eficiente possível, 
você deverá configurá-la de forma explícita com tudo que deseja 
que seja executado de forma automática usando a caixa de diálogo 
Configurar a Limpeza de Código. Selecione na lista Reparados 
disponíveis da janela todas as opções que deverão ser aplicadas e as 
mova para a lista Reparadores incluídos usando os botões de setas. 
Observe: 
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Configurar Limpeza de Código x 


Perfis: Reparadores incluídos: 
Perfil 1 (padrão) Classificar usos 
Perfil 2 Remover Usos Desnecessários 


Reparadores disponíveis: 
Aplicar as preferências de inicialização de objeto/coleção 
Aplicar as preferências de expressão/corpo do bloco 
Aplicar as preferências de qualificação 'this.' 
Aplicar as preferências de tipo implícitas/explícitas 
Remover variáveis não utilizadas 
Remover conversões desnecessárias 
Aplicar as preferências de variáveis 'out' embutidas 
Adicionar modificadores de acessibilidade 











OK N Cancelar 


Figura 10.7: Configurando as opções a serem aplicadas na limpeza de código 














Ao usar a limpeza de código, tenha em mente que ela não 
aplicará todas as ações rápidas e refatorações disponíveis 
nativamente no Visual Studio ou disponibilizadas por extensões de 
terceiros, devido às configurações de gravidade que mencionamos 
previamente e ao fato de que algumas ações envolvem fornecer um 
nome significativo para algo durante o procedimento. 


As regras configuradas com uma gravidade de Nenhum, por 
exemplo, não participam da limpeza de código, mas ainda podem 
ser aplicadas de maneira individual através do menu Ações rápidas 
e refatorações. 


De qualquer modo, a aplicação da limpeza de código 
corretamente configurada impactará de forma significativa no 
volume de trabalho que precisará ser realizado posteriormente de 
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forma manual pelo desenvolvedor. 


10.4 VISUALIZANDO OS RESULTADOS DAS 
MÉTRICAS DE CÓDIGO 


A janela Resultados das Métricas de Código exibe os dados 
gerados pela análise de métricas de código. Para exibir os 
resultados desses cálculos, execute os seguintes passos: 


1. No menu Analisar, selecione o submenu Calcular métricas 
de código e, a seguir, a opção Para a Solução. 

2. A janela será exibida com as métricas já calculadas. Expanda 
a árvore na coluna hierarquia para exibir detalhes de 
métricas de código. 


Confira na imagem a seguir a janela de resultados de métrica 
para uma das aplicações de console usada como exemplo neste 


capítulo: 





a a 


Hierarquia + Índice de Facilidade de... Complexidade Ciclomática Profundidade de Herança Acoplamento de Classes Linhas de Código-fonte Linhas de Código execu... 


i Nenhi 








Pr arp (Dei 
4 () ProdutividadeEmCSharp 
b *%, Pessoa 
b *, Program 


DEE 
PER - 
desi 


Figura 10.8: Exibindo os resultados das métricas de código 


Vejamos o que cada uma das colunas de métricas de código 
significam: 


e Índice de Facilidade de Manutenção (em inglês, 
Maintainability Index) - Calcula um valor de índice entre 0 
e 100 que representa a relativa facilidade de manutenção do 
código. Um valor alto significa melhor facilidade de 
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manutenção. O valor ideal é 100. 


e Complexidade Ciclomática (em inglês, Cyclomatic 
Complexity) - Mede a complexidade do código estrutural. 
Ele é criado pelo cálculo do número de diferentes caminhos 
de código no fluxo do programa (considere instruções ifs, 
switch/case, do, while). O valor ideal é 1. 


e Profundidade de Herança (em inglês, Depth of Inheritance) 
- Indica o número de classes diferentes que herdam uma da 
outra, de volta para a classe base. Interfaces não são levadas 
em consideração. Quanto maior esse número, mais 
profunda a herança e maior o potencial para modificações 
na classe base que resultam em uma alteração significativa. 
Consequentemente, um valor baixo para esta métrica é 
bom e um valor alto é ruim. O valor ideal é 0. 


e Acoplamento de Classes (em inglês, Class Coupling) - Mede 
o acoplamento de classes, ou seja, o quanto uma classe 
depende da outra. Devemos codificar de forma que tipos e 
métodos tenham alta coesão e baixo acoplamento. Um 
valor alto nesta métrica indica um design difícil de 
reutilizar e manter devido às suas muitas interdependências 
com outros tipos. O valor ideal é 0. 


e Linhas de Código-fonte (em inglês, Lines of Source code) - 
Introduzida no Visual Studio 2019, esta métrica indica o 
número exato de linhas de código-fonte presentes no 
arquivo de origem, incluindo linhas em branco. 


e Linhas de Código Executável (em inglês, Lines of Executable 
code) - Introduzida no Visual Studio 2019, esta métrica 
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indica o número aproximado de linhas ou operações de 
código executável. O valor calculado normalmente é 
próximo à métrica anterior, linhas de código, que é a 
métrica baseada em instrução MSIL usada no modo 
herdado. 


Infelizmente, foge ao escopo deste livro uma abordagem mais 


profunda sobre esse assunto. Para saber mais sobre a janela 


resultados de métricas de código e o significado de cada 
métrica, use como ponto de partida as seguintes páginas da 
documentação oficial: 


https://docs.microsoft.com/pt-br/visualstudio/code- 
quality/working-with-code-metrics-data?view=vs-2019 


https://docs.microsoft.com/pt-br/visualstudio/code- 
quality/code-metrics-values?view=vs-2019 





10.5 INSTALANDO EXTENSÕES DE INSPEÇÃO 
DE CÓDIGO E REFATORAÇÃO 


Ao longo deste capítulo, vimos os principais recursos voltados 
para aplicação de regras de estilo e refatoração que estão presentes 
em todas as edições do Visual Studio. Estas ferramentas são 
suficientes para atender às necessidades da maioria dos 
desenvolvedores, mas existem várias extensões no mercado que 
podem suprir as necessidades mais específicas de alguns leitores. 


Para aqueles que precisam de ferramentas mais completas de 
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inspeção de código e refatoração, a boa notícia é que existem 
excelentes produtos para o Visual Studio 2017 e Visual Studio 
2019, tanto gratuitos quanto pagos. Dentre os gratuitos, podemos 
destacar: 


e Roslynator | https://marketplace.visualstudio.com/items? 
itemName=josefpihrt.Roslynator2019 

e SonarLint para Visual Studio 
https://marketplace.visualstudio.com/items? 
itemName=SonarSource.SonarLintforVisualStudio2019 

e StyleCopAnalyzers 
https://www.nuget.org/packages/stylecop.analyzers/ 

e CodeCracker 
https://www.nuget.org/packages/codecracker.CSharp/ 


Dentre as extensões pagas, destacam-se o Resharper da 
JetBrains e o Visual Assist da Whole Tomato que oferecem 
centenas de outros refactorings e um período de teste para que 
você possa avaliá-las: 


e Resharper https://www.jetbrains.com/resharper/ 
e Visual Assist https://www.wholetomato.com/ 


A instalação dessas extensões pode ser feita diretamente pelo 
Visual Studio. Para testar essa alternativa, vamos instalar a 
extensão Roslynator executando os seguintes passos: 


1. No Visual Studio 2019, as extensões ganharam um menu 
específico na IDE. Clique no menu Extensões e selecione a 
opção Gerenciar Extensões. No Visual Studio 2017, você 
encontrará esta opção no menu Ferramentas. 
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2. A caixa de diálogo Gerenciar Extensões será exibida. Note 
que a guia Online está ativa e que a ordenação default dos 
resultados é por popularidade. As extensões pagas que 
mencionamos já aparecem listadas nesta primeira página, 
pois elas estão há muito tempo no mercado e durante muitos 
anos foram as únicas opções disponíveis. 


3. No campo Pesquisar, digite Roslynator para localizar a 
extensão gratuita mais popular (ela contém mais de 500 
refactorings para C#). 


4. O Visual Studio vai localizar a extensão. Clique no botão 
Baixar. A extensão será baixada e sua instalação será 
agendada para quando fecharmos o Visual Studio. Clique no 
botão Fechar para encerrar a caixa de diálogo Gerenciar 
Extensões. 


5. Feche o Visual Studio para que a extensão Roslynator seja 
instalada e ativada. As funcionalidades desta extensão 
estarão disponíveis através do menu de ações rápidas. Veja a 
seguir um exemplo: 














7 = static void Main( ) 

8 { 

9 string titulo = "Produtividade em CH"; 
10 
11 9 ~- if (titulo fE null && titulo $ "") 
a ES + | @ RCS1113 Use 'string.lsNullOrEmpty' method. 
1 Invert operator 
15 Format binary expression on multiple lines 4f (titulo I= null && titulo l= **) = 
16 Replace 'titulo != null! with “string lsNullOrEmpty(titulo)' if (Istring.IsNullorEmpty(titulo)) 

f 


17 Replace 'titulo != null! with "'string.IsNullOrWhiteSpace(titulo)' 1 
Introduzir o local + E 


Inverter If Visualizar alterações 


= Corrigir todas as ocorrências em: Documento | Projeto | Solução 
Encapsular a expressão 


Configurar ou Suprimir problemas + 


Figura 10.9: Aplicando uma alteração sugerida pelo Roslynator 
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Para configurar o Roslynator conforme as suas necessidades, 
execute os seguintes passos: 


1. Clique no menu Ferramentas do Visual Studio e selecione 
Opções. 

2. A caixa de diálogo Opções será aberta. Navegue até o 
submenu do Roslynator (neste caso específico, não utilize a 
caixa de pesquisa, pois se você buscar pelo termo 
Roslynator não verá a opção Refactorings). 

3. Nos submenus Refactorings e code fixes, selecione as opções 
que deseja ativar. Observe que existe um campo de busca 
acima do grid que você pode utilizar para localizar mais 
facilmente uma regra específica que deseja ativar ou 
desativar. 

4. Após efetuar todas as configurações desejadas, clique no 
botão OK para fechar a caixa de diálogo. 
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Opções de Pesquisa (Ctrl+ E) 2 
b Designer de Formulários do Windows A | ld Title Enabled 
b Designer XAML RR0010 Add identifier to variable declaration 
b Fé Tools RR0012 Add identifier to parameter 
b Ferramentas de Banco de Dados RR0066 Introduce constructor 
p Saa E to RR0088 Remove all documentation comments 
b Ferramentas de Teste de Desempenhc RR0138 Replace method with property 
b Ferramentas do Azure Dev Spares RRO171 Convert” to string Empty 
b Ferramentas do Service Fabric 
b Ferramentas Node;js RR0188 Convert 'foreach' to 'for' and reverse loop 
b Gerenciador de Pacotes do NuGet RROOGZ Add braces vi 
b IntelliCode RR0003 Add braces to if-else v] 
b Live Share RRODO4 Add braces to switch section v) 
b Modelagem de Texto RR0005 Add braces to switch sections v 
b Multiplataforma RR0006 Add cast expression v] 
b Python RROOO7 Add default value to parameter 7 
s EES RR0009 Add exception to documentation comment v) 
eds RR0011 Add parameter name to argument v] 
ESD RR0013 Add using directive v 
Code Fixes RR0014 Add using static directive v] 
b Snippet Designer RR0015 Call 'ConfigureAwait(false)' v 
b SQL Server Tools RR0016 Call extension method as instance method v 
b Teste RR0017 Call 'To...' method (ToString, ToArray, ToList) v] 
D Web Forms Designer t ra 
ozaman y| | CheckAll || Uncheck Alt 
< > 

















OK ; Cancelar 


Figura 10.10: Configurando as refatorações ativas do Roslynator 





Saiba que as ferramentas aqui sugeridas são apenas algumas 
dentre muitas gratuitas e pagas que foram construídas para 
otimizar e simplificar o nosso trabalho. Em fóruns como o Stack 
Overflow, em blogs técnicos sobre programação ou em tutoriais no 
YouTube, você encontrará sugestões de outras ferramentas 
fantásticas que merecem fazer parte do nosso dia a dia. 
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CaríruLo 11 


AÇÕES RÁPIDAS E 
REFATORAÇÃO 


A reescrita de um código-fonte usando as melhores práticas 
para torná-lo mais fácil de manter, entender e estender, sem alterar 
seu comportamento, é conhecida como refatoração (em inglês, 
refactoring) e é uma tarefa cada vez mais presente na vida de um 
desenvolvedor ou desenvolvedora profissional. 


Conforme vimos no capítulo anterior, o Visual Studio 2019 
oferece a você, mesmo em sua versão gratuita, um grande leque de 
ferramentas que facilitam a reorganização de projetos já iniciados e 
a correção dos problemas encontrados. A lista inclui analisadores 
de código, regras de estilo de código, ações rápidas, ferramentas de 
refatoração, ferramentas de limpeza de código e ferramentas de 
relatório de métricas de código. 


Neste capítulo, focaremos nas ações rápidas e refatorações para 
linguagem Cf. Como existe um número muito grande de ações 
disponíveis nativamente na IDE, focaremos apenas nas mais 
importantes, ou seja, naquelas que você utilizará com maior 
frequência. 
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Explorando as ações rápidas 


As ações rápidas (em inglês, quick actions) nos permitem 
corrigir, gerar mais código ou refatorar o código existente com um 
único comando. O recurso funciona da seguinte forma: o Visual 
Studio identifica locais em que o código está incorreto e locais em 
que o código pode ser simplificado e/ou melhorado e os sinaliza no 
editor de código com um rabisco ou sublinhado para o 
desenvolvedor. O desenvolvedor percebe que existe algo que pode 
ser modificado em um ponto específico do código e pode acessar o 
menu de ações rápidas de uma das seguintes formas: 


a) Parando o mouse sobre o identificador ou palavra-chave 
sublinhada. Um ícone de marca inteligente de uma lâmpada ou 
chave de fenda será mostrado contendo uma pequena seta à direita 
que, ao ser clicada, mostra o menu de ações rápidas. 


b) Clicando com o botão direito do mouse sobre o 
identificador ou palavra-chave. No menu de contexto que será 
exibido, selecione a opção Ações Rápidas e Refatorações. O menu 
de ações rápidas será exibido. 


c) Parando com o cursor de inserção sobre o identificador ou 
palavra-chave e teclando Ctrl +. (ponto). O menu de ações rápidas 
será exibido. 


É importante destacar que nem todos os locais onde uma ação 
rápida pode ser aplicada serão sinalizados de forma automática 
pelo Visual Studio. Além disso, em uma mesma linha de código 
podem existir diferentes ações rápidas que podem ser listadas 
dependendo de onde você parou o mouse ou o cursor de inserção 
antes de ativar o menu de ações rápidas. 
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Por meio de ações rápidas, é possível: 


e Aplicar uma correção de código para uma violação de regra 
do analisador de código. 

e Suprimir uma violação de regra do analisador de código ou 
configurar sua gravidade. 

e Aplicar uma refatoração. 

e Gerar um código a partir do seu uso. 


Parte das ações rápidas suportadas pelo Visual Studio já foram 
explicadas no capítulo anterior. Por meio delas é possível 
implementar o recurso Geração a partir do uso, como vimos no 
capítulo 09. Nas próximas seções, focaremos em ações rápidas que 
aplicam correções no código existente e refatorações. Como o 
Visual Studio inclui um grande número de ações rápidas e algumas 
são muito específicas (e raramente utilizadas), abordaremos apenas 
as mais úteis. 


Para conhecer as demais ações rápidas, acesse as seguintes 
páginas da documentação: 


https://docs.microsoft.com/pt-br/visualstudio/ide/quick- 
actions?view=vs-2019 


https://docs.microsoft.com/pt-br/visualstudio/ide/common- 
quick-actions?view=vs-2019 


https://docs.microsoft.com/pt- 


br/visualstudio/ide/refactoring-in-visual-studio?view=vs- 
2019 
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Usando atalhos de teclado para refatorar 


Parte das funcionalidades de refatoração de código suportadas 
pelo Visual Studio pode ser acessada via menu principal do Visual 
Studio ou através de atalhos de teclado (em inglês, shortcuts). No 
Visual Studio 2019, as funcionalidades ficam escondidas no 
submenu Refatorar do menu Editar. 


Para facilitar a consulta e a memorização, enumeramos a seguir 
os atalhos de teclado usados por cada refactoring: 


Refatoração Atalho de teclado 
Encapsular campo Ctrl+R, Ctrl+E 
Extrair interface Ctrl+R, Ctrl+I 
Extrair método Ctrl+R, Ctrl+M 


Q 


Remover parâmetros rl+R, Ctrl+V 


Q 


Renomear rl+R, Ctrl+R 





Q 


Reordenar parâmetros rl+R, Ctrl+O 


Na maior parte dos casos, você acabará acessando esses 
recursos de refatoração por meio do menu de contexto ou pelo 
menu de ações rápidas. Memorizar os atalhos só será realmente 
útil se você tiver que realizar um trabalho extenso de refatoração 
de um sistema legado. 


Agora que você já está familiarizado com os conceitos, 
configurações e ferramentas fornecidas pelo Visual Studio, é hora 
de nos divertimos um pouco testando várias funcionalidades 
disponibilizadas na forma de ações rápidas e refatorações que nos 
pouparão muito trabalho. 
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Classificando e removendo usings desnecessários 


Um dos efeitos colaterais de utilizarmos templates de projetos 
e de arquivos é que acabamos muitas vezes com várias linhas de 
importação de namespaces que não são de fato usadas em nosso 
código. Estas importações são sinalizadas pelo Visual Studio em 
uma cor mais clara. Veja: 


EREE Program.cs 














©] ProdutividadeEmCSharp -| ProdutividadeEmCShar 

1 “using System; 
2 [using System.Collections.Ge neraic: | 

H 1 Importações desnecessárias 
3 t ! 

q q q q q q a m e a a e e e e a e e a e e ae a m m e m e a 
4 
5 =namespace ProdutividadeEmCSharp 
6 { 
7 = class Pessoa 
8 { 
9 public string Nome { get; set; } 
10 public int Idade { get; set; } 
11 public char Genero { get; set; } 
12 
13 — public void Apresentarse() 
14 { 
15 Console.WriteLine($"Meu nome é {Nome}"); 
16 } 
17 } 
18 } 


Figura 11.1: Sinalização de importações de namespaces não utilizados 


Você pode remover manualmente cada linha desnecessária 
parando com o cursor de inserção sobre a linha e teclando Ctrl + x 
ou pode usar uma Ação Rápida. Basta clicar com o botão direito do 
mouse sobre qualquer linha referente às importações e selecionar 
no menu de contexto Remover e Classificar Usos. Esta ação 
removerá do arquivo atual qualquer importação de namespace não 
utilizado e, de quebra, ainda os ordenará. 
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Caso deseje apenas remover as importações desnecessárias, 
tecle Ctrl + . sobre uma das linhas de importação de namespace e 
selecione no menu de ações rápidas a opção Remover Usos 
Desnecessários. 


Incluindo usings necessários 


O Visual Studio é capaz de identificar quando tentamos utilizar 
em nosso código um tipo que está definido em assemblies do 
próprio framework .NET/.NET Core, pacotes NuGet ou outros 
namespaces do mesmo projeto ou de outros projetos da solução e 
cujo namespace não foi importado no arquivo atual. 


Quando este cenário ocorre, a IDE nos oferece na ação rápida a 
inclusão da importação do namespace necessário. Veja: 


class Program 














{ 
public static IEnumerable<Pessoa> ObterMaiores(List<Pessoa> pessoas) 
í 
return from Pessoa pessoa in pessoas 
where pessoa.Idade >= &- 
select pessoa; z E 
P i using System.Ling; | + | (4) € C51935 Não foi possível encontrar uma implementação do padrão 
} de consulta para o tipo de origem "List<Pessoa>", "Cast" não encontrado. 
N Está faltando uma referência a "System.Core.dll" ou uma diretiva using pa... 
e using System.Collections.Generic; 
static void Main(string[] ) 
i 


List<Pessoa> pessoas = new List<Pessoa>() 
{ aa 
new Pessoa()(Nome = "Pedro", Idade 
new Pessoa()(Nome = "Paulo", Idade , 
new Pessoa()(Nome = "Marcela", Idade = 16, Genero = 'F'), 


6, 
Visualizar alterações 
18, cs 


Figura 11.2: Incluindo de forma automática a importação de namespaces utilizados 


Renomeando identificadores 


Renomear identificadores de namespaces, tipos, membros e 
variáveis é uma tarefa extremamente simples e rápida no Visual 
Studio. Para ativar o recurso, basta clicar com o botão direito do 
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mouse sobre o identificador ou parar o cursor de inserção sobre ele 
e teclar F2. O identificador será selecionado e a janela da 
ferramenta Renomear será exibida no canto superior direito do 
editor de código. Basta digitar o novo nome para o identificador e 
teclar Enter ou clicar no botão Aplicar. Veja: 












































Arquivo Editar Exibir Projeto Compilação Depurar Teste Análise Ferramentas pesquisar. P| Produbap  — o x 
Extensões Janela Ajuda 
G-H D- ~ Debug - AnyCPU - P ProdutividadeEmCSharp - E. t s IÈ liveShare É 
o a 
e = 
x 8 
à [es ProdutividadeEmCSharp =% ProdutividadeEmCSharp.Program - Q Escrever(string mensagem) 2 
a 3 
T 1 using System; +S 
z 2 Renomear: Escrever x E 
3 E sea o -r 
2 3 “namespace ProdutividadeEmCSharp Modifique qualquer local realçado para iniciar a renomeação. g 
Eg E $ 
4 $ Incluir comments È 
f S e 
Incluir strings b a 
5 E class Program ii 7 
6 {1 Alterações de Preview E 
rência OOOO ss: g 
7# Š a ; ; i Renomear atualizará 2 referências em 1 arquivo. 1 7 
TI private static void Escrever (st ESSES SC ES ) o 
8 E 
é Aplicar 
9 = if (mensagem is null) 
10 { | Aplicar (Enter) 
11 throw new ArgumentNullException(nameof (mensagem) ); 
12 } 
13 
14 Console.WriteLine(mensagem); 
15 } 
16 
17 = static void Main(string[] ) 
18 { 
19 Escrever ("Produtividade em C#"); 
20 } 
21 } 
22 } 


121% ~ © Não foi encontrado nenhum problema | Sw 4 > Ln:7 Car37 SPC CRLF 


M Adicionar ao Co 





Figura 11.3: Utilizando a ferramenta Renomear para alterar o nome de um método 


Conforme você observará nas próximas seções, esta ferramenta 
também é usada durante a aplicação de algumas ações rápidas para 
fornecer um nome significativo no lugar do nome original incluído 
pela ação durante a modificação do código existente. Ao usar a 
janela Renomear, você perceberá que ela informa em quantos 
locais ocorrerão substituição e informa também que existirão 
opções extras que serão incluídas, dependendo do tipo de 
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identificador que está sendo alterado. Por exemplo, ao usar a 
ferramenta para alterar o nome de uma classe, será exibida uma 
opção pré-selecionada que altera também o nome do arquivo que 
contém o código da classe. 


11.1 DIVIDINDO O CÓDIGO DE UMA CLASSE 
EXTENSA EM MÚLTIPLOS ARQUIVOS 


Criar pequenas classes e estruturas com poucas linhas de 
código facilita a leitura e manutenção do código. Essa abordagem é 
recomendada quando se adere aos princípios do SOLID, 
particularmente o Princípio da Responsabilidade Única. No 
entanto, em alguns casos, arquivos grandes são inevitáveis. 


Apesar de ser possível aplicar refatoração do código em alguns 
cenários, pode ser conveniente em certos casos simplesmente 
quebrar a classe em múltiplos arquivos como uma solução 
intermediária para reduzir a complexidade. A linguagem C# torna 
isso possível ao adicionar a palavra-chave partial à definição da 
classe. Deste modo, teremos dois ou mais arquivos no quais a 
classe estará definida. 


Para conferir o uso deste recurso na prática, vamos definir uma 
classe Livro e distribuí-la em dois arquivos, um contendo as 
propriedades, e o outro, os métodos. Nesta primeira listagem 
temos as propriedades que serão definidas no arquivo 


Livro.Propriedades.cs: 
using System; 
namespace ProdutividadeEmCSharp 


{ 


public partial class Livro 
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public string Nome { get; set; } 
public int Id { get; 3 
public string Log { private get; set; } 


public string Titulo { get; set; } = "Produtividade em C& 


public string Autor { get; set; } = "Cláudio Ralha"; 


public DateTime DataCadastramento ( get; private set, } = 
DateTime.Now; 


public decimal Preco ( get; private set; ) = 50; 


No segundo arquivo, que chamaremos de 
Livro.Metodos.cs , temos o código dos métodos: 


namespace ProdutividadeEmCSharp 
{ 

public partial class Livro 

{ 

public string ObterResumo() { 
return "Produtividade em C# é um livro contendo um gr 

ande número de dicas para facilitar o processo de codificação nas 
versões mais recentes da linguagem da Microsoft."; 


} 
public string ObterAutores() 
í 

return "Cláudio Ralha"; 
) 


Confira a seguir os arquivos da classe Livro no Gerenciador 
de Soluções: 
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Gerenciador de Soluções 


AA- 0-58a A|] 


Pesquisar em Gerenciador de Soluções (Ctrl+ç) P- 


[q] Solução 'ProdutividadeEmCSharp' (1 projeto) 
4 ProdutividadeEmCSharp 

b =a Dependências 

b @ Livro-Metodos.cs 

b cœ Livro.Propriedades.cs 

b 





c* Program.cs 


Figura 11.4: Particionando o código de uma classe em múltiplos arquivos 


Obviamente, a forma de nomear os arquivos e de agrupar os 
membros da classe é apenas uma sugestão, você pode utilizar a 
convenção que for mais adequada para o seu caso. 


Movendo um tipo para o arquivo correspondente 


Ainda que não seja uma boa prática de programação, é possível 
definir em um único arquivo de código C# ou Visual Basic 
múltiplos tipos. Essa prática é comumente adotada quando se está 
criando algum código com o propósito de demonstração ou de 
prova de conceito e se deseja manter o máximo de simplicidade. 


Para corrigir esse tipo de cenário, o Visual Studio 
disponibilizou a partir da versão 2017 um refactoring que move o 
tipo definido dentro do arquivo que contém múltiplas definições 
de tipos para um novo arquivo com o mesmo nome do tipo. 
Vamos ilustrar como usar este recurso, partindo do código do 
arquivo Program.cs mostrado a seguir: 


using System; 
namespace ProdutividadeEmCSharp 
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public class Pessoa 


{ 
public string Nome { get; set; } 
public int Idade { get; set; } 


class Program 


{ 
static void Main(string[] args) 
{ 
Pessoa pessoa = new Pessoa() 
{ 
Nome = "Cláudio Ralha", 
Idade = 45 
J; 
Console.writeLine($"Nome: {pessoa.Nome}"); 
Console.writeLine($"Idade: {pessoa.Idade}"); 
} 
} 


Conforme você pode observar, a classe Pessoa foi definida no 
mesmo arquivo da classe Program . Para movê-la para um arquivo 


à parte, execute os seguintes passos: 


1. Clique com o botão do mouse sobre o nome da classe e 
selecione no menu de contexto a opção Ações Rápidas e 
Refatorações. 


2. No menu que será exibido, selecione a opção Mover tipo 
para Pessoa.cs. 
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using System; 


Fnamespace ProdutividadeEmCSharp 
$ 


Awu nha 


2 referências 


Sf E public class Pessoa 


Mover tipo para Pessoa.cs N L] is 
í 


€ 


7 Mover para o namespace... 
Gerar construtor... 

i Gerar Equals(object)... 
Gerar Equals e GetHashCode... 


1€ 
14 Gerar substituições... 





Gerar construtor "Pessoa()" 


12 FA Visualizar alterações 
` Extrair interface... 


r O referências 

14 E static void Main(string[] args) 

15 { 

16 E Pessoa pessoa = new Pessoa() 

17 { 

18 Nome = “Cláudio Ralha", 

19 Idade = 45 

20 3; 

21 Console.WriteLine($"Nome: (pessoa.Nome)"); 


22 Console.WriteLine($"Idade: fpessoa.Idade)"); 











Figura 11.5: Movendo a classe para um arquivo exclusivo 


Isso é tudo! Agora cada código está em seu devido lugar. Vale 
destacar que, se o arquivo Pessoa.cs já existisse, o arquivo 
previamente criado não seria usado. O Visual Studio iria criar um 
arquivo com o nome de Pessoai.cs e salvar a definição do tipo 
nele. 


Sincronizando o nome do tipo com o nome do 
arquivo 


Há casos em que temos uma definição de tipo dentro de um 
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arquivo cujo nome não corresponde ao nome do tipo. A partir do 
Visual Studio 2017, é possível sincronizar o nome do tipo com o 
nome do arquivo através de novas refatorações suportadas pela 
IDE. 


Vamos supor que tenhamos um arquivo nomeado como 
Cliente.cs , no qual está definida a classe Pessoa , cujo código 
está listado a seguir: 


namespace ProdutividadeEmCSharp 


{ 
public class Pessoa 
{ 
public string Nome { get; set; } 
public int Idade { get; set; } 
3 
3 
Para vermos essa refatoração em ação, execute os seguintes 
passos: 


1. Clique com o botão direito do mouse sobre o nome de tipo. 
Selecione no menu de contexto a opção Ações Rápidas e 
Refatorações. 


2. O menu da marca inteligente será exibido. Selecione a opção 
Renomear tipo para Cliente. 
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1 -namespace ProdutividadeEmCSharp 


2 { 
34 <E public class Pessoa 
4 : z 
Renomear tipo para Cliente No] Grã 
í 
c Mover para o namespace... ERR pessoa = new FER 
Gerar construtor... pessoa = new flienta() 
€ i 


Gerar Equals(object)... 
Gerar Equals e GetHashCode... 


SE Visualizar alterações 
Gerar substituições... 


LA 


Gerar construtor "Pessoal" 


Extrair interface... 


Figura 11.6: Renomeando o tipo para o nome do arquivo 


Conforme esperado, a classe será renomeada para Cliente . 
Obviamente, para nomes curtos pode ser menos trabalhoso alterar 
manualmente o nome da classe para sincronizá-lo com o do 
arquivo, mas se o nome for complexo e longo, você vai agradecer 
ao time de desenvolvimento do Visual Studio por ter incluído essa 
funcionalidade. 


É importante destacar que a Microsoft chegou a disponibilizar 
em versões de teste do Visual Studio 2017, uma opção que fazia o 
oposto, ou seja, renomeava o arquivo para o nome do tipo 
declarado (Renomear arquivo para Pessoa.cs, neste exemplo), mas 
essa refatoração não está mais disponível. 


Sincronizando namespaces e nomes de pastas 


Sincronizar os nomes de namespaces com os nomes e a 
estrutura de pastas em uso nos projetos nos ajuda a manter o 
código organizado de forma mais intuitiva. Para ilustrar este 
cenário, vamos criar uma classe Pessoa em um projeto de 
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aplicação de console: 


namespace ProdutividadeEmCSharp 


{ 
class Pessoa 
{ 
public string Nome { get; set; } 
public int Idade { get; set; } 
public char Genero { get; set; } 
} 
} 


O arquivo Pessoa.cs está localizado originalmente na pasta 
raiz. Confira na imagem a seguir: 





Gerenciador de Soluções 
AB- osam A|- 


Pesquisar em Gerenciador de Soluções (Ctrl+ç) p~ 


m] Solução 'ProdutividadeEmCSharp' (1 de 1 projeto) 
4 ProdutividadeEmCSharp 

b «a Dependências 

bp c Pessoa.cs 

b c Program.cs 


Figura 11.7: Estrutura de arquivos inicial do projeto 


Em determinado momento do projeto, você decidiu que criaria 
uma pasta Modelos e, dentro dela, uma pasta Entidades para 
armazenar todas as classes de entidades do sistema. Para criar estas 
pastas, clique com o botão direito do mouse sobre o local desejado 
no Gerenciador de Soluções e selecione no menu de contexto o 
submenu Adicionar e a seguir a opção Pasta. Entre com o nome 

Modelos . Repita o processo fornecendo o nome Entidades . O 
resultado final pode ser visto a seguir: 
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Gerenciador de Soluções 
QA- v- sam A[-| 
Pesquisar em Gerenciador de Soluções (Ctrl+ç) p~ 
ta] Solução 'ProdutividadeEmCSharp' (1 de 1 projeto) 
4 ProdutividadeEmCSharp 
b i Dependências 
4 “| Modelos 


b c Pessoas 
b c Program.cs 


Figura 11.8: Estrutura de pastas criadas para organizar o código 


Para mover o arquivo Pessoa.cs para apasta Entidades , 
clique com o mouse sobre o arquivo Pessoa.cs no Gerenciador 
de Soluções e, enquanto mantém apertado o botão, arraste-o para o 
local desejado. Ao soltar o arquivo, uma caixa de confirmação será 
mostrada. Clique no botão OK para confirmar que deseja mover o 
arquivo. 


Com o arquivo Pessoa.cs já no local adequado e aberto no 
editor de código, clique com o botão direito do mouse sobre o 
identificador do namespace e selecione no menu de ações rápidas a 
opção Alterar 0 namespace para 
ProdutividadeEmCSharp. Modelos. Entidades. Veja: 
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11 


2 ~ “namespace ProdutividadeEmCSharp 





* Alterar o namespace para 'ProdutividadeEmCSharp.Modelos.Entidades' L] 


M REF namespace ProdutividadeEmCSharp 
Ai Ner comtenco R O ASPE namespace ProdutividadeEmCSharp.Modelos. Entidades, 
5 { {i 
6 public string Nome { get; set; } /N Aviso: a alteração do namespace pode produzir 
ES Visualizar alterações 
7 public int Idade { get; set; } E 
8 public char Genero ( get; set; ) 
9 } 
10 ) 


Figura 11.9: Aplicando a ação rápida de alteração de namespace 


Pronto! O namespace foi ajustado sem risco de erro de 
digitação com o mínimo de esforço. 


11.2 CONVERTENDO UM TIPO ANÔNIMO 
EM UMA CLASSE 


O Visual Studio 2019 inclui uma ação rápida que nos permite 
converter um tipo anônimo em uma classe. Para testá-la, vamos 
utilizar o programa de exemplo a seguir: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
var livro = new 
{ 
Titulo = "Produtividade em C&", 
Autor = "Cláudio Ralha", 
Editora = "Casa do Código" 
Ji 


Console.WwriteLine($"Título: {livro.Titulo}\nAutor: {1 
ivro.Autor}\nEditora: {livro.Editora}"); 
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Para testar esta ação rápida, clique com o botão direito do 
mouse sobre a palavra-chave new e selecione no menu de 
contexto Ações Rápidas e Refatorações. No menu seguinte, 
selecione Converter em classe. Veja: 


0 referências 
class Program 

















e || f 

7 fe static void °  ; 

8 | { var livro = new 

sẹ] BEE Liv var livro = new NewClass{] 
1€ converter a tupla 

1 Introduzir o local + 
1: Converter em classe , 
14 Configurar ou Suprimir problemas + [i 
15 | Console 


16 | } internal class NewClasg 
7 

[5 i 

| 


} 








tulo == other.Titulo && 


Autor == other.Autor 88 





public override int GetHashCode()) 
E 


return HashCode.Combine(Titulo, Autor, Editora); 


} 
} 


Figura 11.10: Convertendo um tipo anônimo em classe 


A conversão será realizada e em seguida será ativada a 
ferramenta de Renomear para atribuir um nome mais intuitivo do 
que NewClass à classe. Para este exemplo, atribua Livro. O 
resultado final da conversão pode ser visto na listagem a seguir: 


using System; 
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namespace ProdutividadeEmCSharp 
{ 
class Program 
{ 
static void Main(string[] args) 
{ 
var livro = new Livro( 
"Produtividade em C#", 
"Cláudio Ralha", 
"Casa do Código" 
); 
Console.WwriteLine($"Título: {livro.Titulo}\nAutor: {1 
ivro.Autor}\nEditora: {livro.Editora}"); 
3 
3 


internal class Livro 

{ 
public string Titulo { get; } 
public string Autor { get; } 
public string Editora { get; } 


public Livro(string titulo, string autor, string editora) 
{ 

Titulo = titulo; 

Autor = autor; 

Editora = editora; 


} 


public override bool Equals(object obj) 
{ 


return obj is Livro other && 
Titulo == other.Titulo && 
Autor == other.Autor && 
Editora == other .Editora; 


} 


public override int GetHashCode() 


{ 


return HashCode.Combine(Titulo, Autor, Editora); 


} 
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Na maioria dos casos, será necessário algum ajuste manual 
para remover o código extra desnecessário. 


11.3 PROMOVENDO UM MEMBRO DE UMA 
CLASSE A UMA INTERFACE OU TIPO BASE 


O Visual Studio 2019 disponibiliza uma ação rápida que nos 
permite puxar um método definido em uma classe para uma 
interface que a classe implementa, ou para uma classe base da qual 
a classe que contém o método deriva. 


Para simular um cenário em que este tipo de ação pode ser útil, 
vamos partir do código em desenvolvimento a seguir: 


namespace ProdutividadeEmCSharp 


: public interface ITributavel 
{ 
} 
public abstract class Conta 
: public double Saldo { get; set; } 
} 


public class ContaPoupanca : Conta, ITributavel 


{ 
public double CalcularTributo() 


t return Saldo * 0.05; 
} 
} 
class Program 
{ 
static void Main(string[] args) 
{ 
} 
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Note que o programa que fornecemos nesta listagem não está 
completo. Vamos supor que, durante a codificação do método 
CalcularTributo na classe ContaPoupanca , você perceba que 
o método deve fazer parte da interface ITributavel , que deverá 
ser implementada em todos os tipos de contas que sofrerão 
tributação, incluindo ContaInvestimento , que ainda não foi 
codificada. O método em questão não pode fazer parte da classe 
abstrata Conta , pois há certos tipos de contas que não sofrem 
tributação. 


Para promover o método CalcularTributo à interface 
ITributavel , basta clicar com o botão direito do mouse sobre o 
identificador e selecionar no menu de ações rápidas a opção. Veja: 


13 = public class ContaPoupanca : Conta, ITributavel 


14 { 
149º = public double CalcularTributo() 


x Substituir “CalcularTributo" por uma propriedade 


t í 


1 Usar o corpo da expressão para métodos 
1c Efetue pull de 'CalcularTributo' até 'ITributavel' sb] double CalcularTributo()4 
26 Efetue pull de 'CalcularTributo' até 'Conta' } 


Efetuar pull de membros até o tipo base... 


21 - class Program Visualizar alterações 
22 { 

23 = static void Main(string[] args) 
24 { 

25 } 

26 } 

27 } 


Figura 11.11: Promovendo o método CalcularTributo à interface ITributavel 


Após a aplicação da ação, o código ficará como mostrado na 
próxima listagem: 
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namespace ProdutividadeEmCSharp 


{ 
public interface ITributavel 
{ 
double CalcularTributo(); 
3 
public abstract class Conta 
{ 
public double Saldo { get; set; } 
3 
public class ContaPoupanca : Conta, ITributavel 
{ 
public double CalcularTributo() 
{ 
return Saldo * 0.05; 
3 
3 
class Program 
{ 
static void Main(string[] args) 
{ 
3 
3 
} 


Note que agora o método CalcularTributo faz parte da 
interface ITributavel e sua implementação é feita na classe 
ContaPoupanca . Se tivéssemos promovido o método 
CalcularTributo à classe base Conta no lugar da interface 
ITributavel , o código do método seria movido para a classe 
base, ou seja, deixaria de existirem ContaPoupanca . 


Nesta nossa simulação, a mudança pode parecer bem simples, 
pois todas as classes e interfaces foram codificadas no arquivo 
Program.cs para simplificar a explicação. Mas o real valor deste 
recurso é sentido quando aplicamos esta ação em projetos do 
mundo real, nos quais cada classe e interface está em um arquivo 
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diferente. 


11.4 CONVERTENDO CAMPOS EM 
PROPRIEDADES 


A ação rápida de encapsular um campo cria uma nova 
propriedade com o mesmo nome do campo. Para ilustrar o seu 
uso, vamos partir do exemplo da classe Pessoa a seguir: 


namespace ProdutividadeEmCSharp 


f class Pessoa 
{ 
public string Nome; 
} 
} 


Observe que a classe Pessoa utiliza um campo Nome no 
lugar de uma propriedade. Para converter este campo em uma 
propriedade, clique com o botão direito do mouse sobre o 
identificador da propriedade e selecione no menu de ações rápidas 
a opção Encapsular campo "Nome” (e usar propriedade). Veja: 


3 - class Pessoa 
4 { 
14 - public string Nome; 
€ 











Encapsular campo: "Nome" (e usar propriedade) À 





| Encapsular campo: "Nome" (mas ainda usar o campo) í 
J 





9 


public string Nome { get => nome; set => nome = value; } 


} 


Visualizar alterações 


Figura 11.12: Convertendo um campo em uma propriedade 


Confira o resultado na próxima listagem: 
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namespace ProdutividadeEmCSharp 


: class Pessoa 
{ 
private string nome; 
public string Nome { get => nome; set => nome = value; } 
3 
3 


Note que esta conversão provavelmente não agradará a maioria 
dos leitores e leitoras que esperavam ver uma conversão direta 
para uma propriedade autoimplementada. Para chegar a esse 
resultado, é necessário executar uma vez mais o menu de ações 
rápidas conforme descrito na próxima seção. 


Convertendo propriedades em propriedades 
autoimplementadas 


O Cf suporta propriedades autoimplementadas como uma 
forma mais concisa de implementarmos propriedades. Na seção 
anterior, vimos que a conversão de um campo em uma 
propriedade usando uma ação rápida resultou na implementação 
de uma propriedade que ainda mantém a definição de uma 
variável interna declarada para armazenar o valor da propriedade. 


Para converter a propriedade Nome em uma propriedade 
autoimplementada, clique com o botão direito do mouse sobre o 
identificador da propriedade e selecione no menu de ações rápidas, 
a opção Usar a propriedade Auto: 
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3 = class Pessoa 
4 { 
5 
6 


10 + public string Nome ( get => nome; set => nome = value; } 


é E 
d Usar a propriedade auto N L] i IDE0032 Usar a propriedade auto 


- Substituir 'Nome' com métodos 


16 
Configurar ou Suprimir problemas » í Private string nome;] 


public string Nome { ge 
public string Nome { get; set; } 
k 





Visualizar alterações 
Corrigir todas as ocorrências em: Documento | Projeto | Solução 


Figura 11.13: Convertendo uma propriedade em uma propriedade autoimplementada 


Confira o resultado na próxima listagem: 


namespace ProdutividadeEmCSharp 


i class Pessoa 
{ 
public string Nome { get; set; } 
} 
} 


Por enquanto, ainda não há como partir de um campo e chegar 
em uma propriedade autoimplementada usando uma única ação 
rápida, sem recorrer a um plugin externo. Todavia, esta é uma área 
do Visual Studio que vem recebendo melhorias constantes e é bem 
provável que essa restrição deixe de existir em breve. 


11.5 PROMOVENDO FUNÇÕES LOCAIS A 
MÉTODOS 


As funções locais foram introduzidas no C# 7.0 e permitem que 
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um método local seja definido e chamado dentro de outro método. 
Esse tipo de função pode ser declarada dentro de métodos, 
construtores, acessadores de propriedade, acessadores de eventos, 
métodos anônimos, expressões lambda, finalizadores e de outras 
funções locais. 


Há desenvolvedores que apreciam a funcionalidade e outros 
que a consideram totalmente desnecessária. Confesso que me 
incluo no segundo grupo que nunca achou motivos reais 
suficientes para definir uma função local. A justificativa para as 
funções locais na documentação oficial é a seguinte: 


“Funções locais tornam a intenção do seu código clara. 
Qualquer pessoa que ler seu código poderá ver que o método não 
pode ser chamado, exceto pelo método que o contém. Para 
projetos de equipe, elas também impossibilitam que outro 
desenvolvedor chame o método por engano diretamente de 
qualquer outro lugar na classe ou no struct". (Fonte: 
https://docs.microsoft.com/pt-br/dotnet/csharp/programming- 
guide/classes-and-structs/local-functions.) 


Para aqueles que não apreciam a funcionalidade, o Visual 
Studio 2019 disponibiliza uma ação rápida que permite converter 
uma função local em um método de uma classe. 


Para testar este recurso, vamos utilizar o código de exemplo a 
seguir: 


using System; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


{ 


static void Main(string[] args) 


332 11.5 PROMOVENDO FUNÇÕES LOCAIS A MÉTODOS 


int Somar(int a, int b) 


{ 


return a + b; 


Console.writeLine(Somar(10, 20)); 
Console.Readkey(); 


Observe que dentro do método estático Main , ponto de 
entrada da aplicação, definimos a função local Somar . Para 
transformá-la em um método estático, basta clicar com o botão 
direito do mouse sobre o seu identificador e selecionar no menu de 
ações rápidas a opção Converter em método. 


7 E static void Main(string[] args) 
8 | { 

co. int Somar(int a, int b) 

a Alterar a função local para 'static' 


: f 
17 Alterar assinatura... int Somar (int a, int b) 
4: Usar o corpo da expressão para funções locais 
14 Converter em método N L] = p 
1 
1º Encapsular cada parâmetro + 
16 a private static fint Somar(int a, int b) 
Desencapsular e recuar todos os parâmetros f 
zj Configurar ou Suprimir problemas + return a + b; 
E7 } 


} 


Visualizar alterações 


Figura 11.14: Convertendo uma função local em um método 


Após a aplicação da ação, o código ficará como mostrado na 
próxima listagem: 
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using System; 


namespace ProdutividadeEmCSharp 


E class Program 
{ 
static void Main(string[] args) 
{ 
Console.writeLine(Somar(10, 20)); 
Console.Readkey(); 
3 
private static int Somar(int a, int b) 
{ 
return a + b; 
3 
3 
3 


11.6 REORDENANDO OS PARÂMETROS DE 
UM MÉTODO 


Ao criar bibliotecas de classes, você pode decidir refatorar seu 
código para fornecer uma ordem consistente de parâmetros. Quem 
já tentou realizar uma mudança desse tipo de forma manual em 
métodos que são largamente utilizados sabe o tempo que uma ação 
dessas consome e quão propensa a erros ela é. Felizmente, o Visual 
Studio dispõe de um excelente conjunto de ferramentas de 
refatoração. 


Neste ponto, alguns leitores podem estar se perguntando: por 
que eu iria querer trocar a ordem de parâmetros de métodos que já 
estão bem testados? Existem alguns motivos principais, vejamos. 
Às vezes, ao ler o código existente, você encontrará métodos com 
parâmetros que são ordenados ilogicamente ou métodos em que os 
parâmetros aparecem em uma ordem diferente de outros métodos 
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semelhantes. Nesses cenários, pode ser desejável que os parâmetros 
apareçam em uma ordem consistente e lógica. Para atingir esse 
objetivo, será necessário atualizar a assinatura do método e o 
código de cada chamada para esse método. 


A ferramenta Reordenação de Parâmetros do Visual Studio 
automatiza todo o processo. Em vez de atualizar manualmente o 
código, o comando fornece uma caixa de diálogo que permite 
alterar interativamente a ordem dos parâmetros de um método. 
Uma vez aceito, o Visual Studio modifica automaticamente o 
método e todas as referências a ele que aparecem na solução atual. 


Para conferir como essa ferramenta pode ser usada para alterar 
a ordem dos parâmetros dos métodos existentes, partiremos do 
seguinte código de teste: 


using System; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


{ 


public static void Escrever(string mensagem, bool capital 
izar, ConsoleColor cor) 


{ 
Console.ForegroundColor = cor; 
mensagem = capitalizar ? mensagem.ToUpper() : mensage 
m, 
Console.writeLine(mensagem) ; 
3 


static void Main(string[] args) 
{ 
Console.BackgroundColor = ConsoleColor.Black; 
Console.Clear(); 
Escrever("Produtividade em C&", true, ConsoleColor.Gr 
een); 
Escrever("Cláudio Ralha", false, ConsoleColor.Yellow) 
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Escrever("aprenda o jeito moderno de programar e extr 
aia o máximo da linguagem em pouco tempo!", false, ConsoleColor.w 
hite); 


Para utilizar a ferramenta de reordenação de parâmetros, 
execute os seguintes passos: 


1. Clique com o botão direito do mouse sobre a declaração do 
método Escrever e selecione no menu de contexto a opção 
Ações Rápidas e Refatorações. 


2. O menu da marca inteligente será então exibido. Clique na 
opção Alterar Assinatura. 


3. A caixa de diálogo Alterar Assinatura será exibida. Observe 
que os parâmetros estão sendo exibidos em uma lista na 
mesma ordem da assinatura do método. Selecione o 
parâmetro desejado e use os botões de setas para movê-lo 
para a posição desejada. Repita esse procedimento para os 
demais parâmetros que desejar mover. 
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Alterar Assinatura ? x 
Parâmetros: 
Modificador Tipo Parâmetro Padrão 
: 
bool capitalizar 
ConsoleColor cor 
Remover 
Restaurar 
Visualizar assinatura do método: 
public static void Escrever(string mensagem, bool capitalizar, ConsoleColor cor) 
Visualizar alterações de referência 
OK Cancelar 








Figura 11.15: Acessando a ferramenta Alterar Assinatura 


4. Para este exemplo, mudaremos apenas o parâmetro cor 
para a segunda posição. Quando estiver satisfeito com a nova 
assinatura, clique no botão OK para confirmar a mudança. 


Isso é tudo! Simples, rápido e sem erros! Compile e execute o 
projeto para verificar que as alterações foram corretamente 
aplicadas a todos os projetos da solução atual. 


11.7 ADICIONANDO NOMES DE 
ARGUMENTOS 


No capítulo 4, apresentamos alguns exemplos de uso de 
parâmetros nomeados que ajudam a aumentar a legibilidade do 
código, especialmente quando um método recebe vários 
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argumentos do mesmo tipo. 


O Visual Studio 2017 e superior inclui uma ação rápida que 
nos permite trabalhar com parâmetros nomeados. Para testar o 
recurso, vamos utilizar o programa a seguir: 


using System; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


{ 


static void Main(string[] args) 


{ 
var aniversario = new DateTime(1973, 4, 19); 
Console.WwriteLine($"Eu nasci em uma {aniversario.ToLo 
ngDateString()}!"); 


} 


Observe que o construtor da classe DateTime , utilizado para 
instanciar o objeto, recebe três argumentos numéricos. Para 
identificarmos com facilidade qual deles representa o mês e qual 
representa o dia da data, clique com o botão direito do mouse 
sobre o primeiro argumento (neste exemplo, 1973 ) e selecione no 
menu de ações rápidas a opção Adicionar nome de argumento 
"year" (incluindo argumentos à direita). Veja: 


8 = static void Main(string[] args) 


9 { 
164 ~ var aniversario = new DateTime(1973, 4, 19); 


13 Introduzir a constante + ... 

4 TE í 

TE eSa a E N var aniversario = new DateTime(1973, 4, 19); 

1. Adicionar nome de argumento year (incluindo argumentos à dit +] var aniversario = new DateTine(fear: 973, homens, Pay: ho); 
ndi am BIS Console.WriteLine($"Eu nasci em uma (aniversario. TolongDateString())!")3 

Converter para hexa 

Separar milhares Visualizar alterações 

Encapsular cada argumento + 


Desencapsular e recuar todos os argumentos 


Figura 11.16: Incluindo nomes para os argumentos 
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Após aplicar a ação, a linha de código de declaração da variável 
aniversario ficará como mostrado a seguir: 


var aniversario = new DateTime(year: 1973, month: 4, day: 19); 


11.8 ADICIONANDO CHECAGEM DE NULOS 
PARA PARÂMETROS 


O Visual Studio 2019 inclui ações rápidas que nos permitem 
verificar os parâmetros passados para um método ou construtor de 
classe. Para testar esse recurso, vamos utilizar o programa a seguir: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
private static void Escrever(string mensagem) 
{ 
Console.writeLine(mensagem); 
3 
static void Main(string[] args) 
{ 
Escrever ("Produtividade em C#"); 
3 
3 
5 


Ao clicar com o botão direito do mouse sobre o parâmetro 
mensagem do método Escrever e acessar o menu de Ações 
Rápidas, veremos as seguintes opções: 
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3 -namespace ProdutividadeEmCSharp 





4 { 

5 z class Program 

6 { 

14 -E private static void (string mensagem) 
é Adicionar verificação nula [+] ala 

c 

- Adicionar a verificação 'string.lsNullOrEmpty' í 


if (mensagem is null) 
11 Adicionar a verificação 'string.lsNullOrWhiteSpace' 


throw new ArgumentNullException(nameof(mensagem)); 


F 


Alterar assinatura... 


13 Usar o corpo da expressão para métodos 
13 i Console.WriteLine(mensagem); 


Visualizar alterações 


Figura 11.17: Incluindo checagem de nulo para o parâmetro mensagem 


Note que as três opções relacionadas à adição de verificação 
nos permitem testar: 


e Apenas por nulos. 
e Por nulos ou string vazia. 
e Por nulos, string vazia ou espaços em branco. 


Confira a seguir o código do método Escrever após a 
refatoração usando a primeira opção, Adicionar verificação nula: 


private static void Escrever(string mensagem) 


{ 
if (mensagem is null) 
{ 
throw new ArgumentNullException(nameof(mensagem)); 
3 
Console.writeLine(mensagem) ; 
3 


Esse recurso se torna ainda mais útil e produtivo quando temos 
múltiplos parâmetros de tipos de referência no mesmo método. 
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Nesse caso, é mostrada uma opção extra que permite adicionar 
checagem de nulo para todos os parâmetros em uma única ação. 


Confira: 
14 E private static void Escrever(string mensagem, string autor) 
$ Adicionar verificação nula 
- Adicionar a verificação 'string.IsNullOrEmpty' ei . 
1 if (string. IsNullorEmpty (mensagem) ) 
47 Adicionar a verificação 'string NulOrWhiteSpace! 
* Adicionar verificações nulas para todos os parâmetros [y throw new ArgumentException("message”, nameof (mensagem) ); 
2 Alterar assinatura... i 
* Usar o corpo da expressão para métodos if (string. IsNullorEmpty(autor)) 
Encapsular cada parâmetro + throw new ArgumentException( "message", nameof(autor)); 


- Desencapsular e recuar todos os parâmetros 
€ 


1 

1 

1 

15 

1 

17 } Console.WriteLine(mensagem); 
Visualizar alterações 


Figura 11.18: Incluindo checagem de nulo para todos os parâmetros 


11.9 USANDO O COMANDO DE EXTRAÇÃO 
DE MÉTODO 


Quando um método cresce além do esperado e sua 
manutenção se torna dificil, ou quando temos uma seção de um 
método que será duplicada em outras partes do nosso código, uma 
boa solução é considerar a extração de parte do código em seu 
próprio método. Para a nossa sorte, o Visual Studio pode 
automatizar esse processo de refatoração através do comando 
Extrair Método. Quando usado corretamente, o processo simplifica 
o código melhorando sua legibilidade e facilitando a sua 
manutenção, uma vez que incentiva a reutilização e reduz a 
duplicação de código. 


O funcionamento do comando de extração de método é bem 
simples. Após o desenvolvedor selecionar um número de linhas 
dentro de um membro de uma classe, o Visual Studio vai extrair o 
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código em seu próprio método, substituindo as linhas originais por 
uma chamada para o novo membro. 


Durante a geração do código, a ferramenta vai examinar o 
código que está sendo extraído para determinar se um ou mais 
valores de retorno serão necessários e para identificar quais 
variáveis devem se tornar parâmetros do novo método. Cada um 
desses itens é implementado automaticamente. 


A forma mais simples de extração de método move uma seção 
de código reutilizável para seu próprio método. Este novo método 
não requer parâmetros e não retornará um valor. O método será 
privado e será um membro estático ou de instância para 
corresponder ao membro do qual o código foi extraído. Para 
ilustrar este cenário, vamos partir do código da próxima listagem: 


using System; 


namespace ProdutividadeEmCSharp 
{ 
class Program 
{ 
static void Main(string[] args) 
{ 
Console.BackgroundColor = ConsoleColor.Black; 
Console.ForegroundColor = ConsoleColor.Green; 
Console.Clear(); 
Console.writeLine("Produtividade em C&"); 
Console.writeLine("Cláudio Ralha"); 
Console.writeLine("Aprenda o jeito moderno de program 
ar e extraia o máximo da linguagem em pouco tempo!"); 


} 


Para extrair um conjunto de linhas de códigos e transformá-las 
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em um novo método, execute os seguintes passos: 


1. Selecione as linhas desejadas. Elas precisam ser linhas 
consecutivas. Em nosso caso, vamos selecionar as seguintes linhas: 
Console.BackgroundColor = ConsoleColor.Black; 
Console.ForegroundColor = ConsoleColor.Green; 

Console.Clear(); 

2. Clique com o botão direito do mouse sobre a seleção e 
selecione no menu de contexto a opção Ações Rápidas e 
Refatorações. 


3. O menu da marca inteligente será exibido. Clique na opção 
Extrair Método. 


O referências 


= E class Program 

6 { 

7 E static void Main(string[] args) 

8 í 

9 Console.BackgroundColor = ConsoleColor.Black; 
10 | Console. ForegroundColor = ConsoleColor.Green; 
Ng ~ Console.Clear(); 
1 Extrair Método | + |... 

> > am 
14 NewMethod(); de programar 
15 Console.WriteLine("Produtividade em C&"); 
16 f ... 
17 | $ private static void NewMethod() 
18 i 
19 } Console.BackgroundColor = ConsoleColor.Black; 


Console.ForegroundColor 
Console.Clear(); 


ConsoleColor.Green; 


Visualizar alterações 


Figura 11.19: Aplicando a ação rápida de extração de método 
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4. O método recém-criado será nomeado como NewMethod e 
imediatamente a ferramenta de renomear método será ativada 
para que possamos trocar o nome do método. 
































1 using System; 
a Par j Renomear: NewMethod x 
3 =nemespace ProdutividadeEmCSharp Modifique qualquer local realçado para iniciar a renomeação. 
4 { Incluir comments 
[ Incluir strings 
5 = class Program TE 
6 $ Alterações de Preview 
7 L static void Main(string[] args) Renomear atualizará 2 referências em 1 arquivo. 
8 t Aplicar 
9 5 
10 Console.WriteLine("Produtividade em C&"); 
11 Console.WriteLine("Cláudio Ralha"); 
12 Console.WriteLine("Aprenda o jeito moderno de programar e extraia o máximc 
13 } 
14 
15 = private static void NewMethod() 
16 { 
17 Console.BackgroundColor = ConsoleColor.Black; 
18 Console.ForegroundColor = ConsoleColor.Green; 
19 Console.Clear(); 
20 } 
21 } 


Figura 11.20: Acessando a ferramenta de renomear 


5. Altere o nome do método deste egemplo para 
ConfigurarTela ea seguir clique no botão Aplicar. 


Observe que o novo nome é assumido ao longo do código. 
Após a extração, o código selecionado foi movido para um novo 
método e substituído por uma chamada para esse método. 


Em alguns casos, o novo método exigirá parâmetros e um valor 
de retorno. O Visual Studio analisará o código selecionado pelo 
desenvolvedor para determinar se esse é o caso e criá-los de 
acordo. Para testar esse cenário, vamos partir do código da 
listagem a seguir: 


using System; 


344 11.9 USANDO O COMANDO DE EXTRAÇÃO DE MÉTODO 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
Console.write("Nome:"); 
string nome = Console.ReadLine(); 
Console.write("Idade:"); 
int idade = Convert.ToInt16(Console.ReadLine()); 
string status = string.Empty; 
status = idade >= 18 ? "Maior de Idade" : "Menor de i 
dade"; 
Console.writeLine(status); 
3 
3 
3 
Selecione as duas linhas a seguir e aplique a extração de 
método: 


string status = string.Empty; 
status = idade >= 18 ? "Maior de Idade" : "Menor de idade"; 


Observe que o novo método exigirá um parâmetro e retornará 
a string informando o status do usuário. Renomeie o método para 
obterStatusMaioridade : 


using System; 


namespace ProdutividadeEmCSharp 
{ 
class Program 
{ 
static void Main(string[] args) 
{ 
Console.write("Nome:"); 
string nome = Console.ReadLine(); 
Console.write("Idade:"); 
int idade = Convert.ToInt16(Console.ReadLine()); 
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string status = obterStatusMaioridade(idade); 
Console.writeLine(status); 


3 
private static string obterStatusMaioridade(int idade) 
{ 
string status = string.Empty; 
status = idade >= 18 ? "Maior de idade" : "Menor de i 
dade"; 
return status; 
3 
3 
5 


Em casos mais complexos, teremos códigos reutilizáveis que 
podem ser extraídos, mas somente se o novo método incluir mais 
de um valor de retorno. Quando esse for o caso, a operação de 
refatoração criará parâmetros de saída ou de referência para esses 
valores de retorno. 


Conforme você pode observar, essa é uma daquelas 
ferramentas que poupa o desenvolvedor e desenvolvedora do 
trabalho braçal e de boa parte do trabalho intelectual de refatorar o 
código-fonte. 


Removendo variáveis não utilizadas 


Durante o desenvolvimento dos métodos de uma classe ou 
struct, por vezes declaramos variáveis que acabam não sendo 
usadas. O editor do Visual Studio nos avisa da presença de código 
desnecessário, sublinhando os identificadores das variáveis em 
verde, e oferece uma ação rápida que nos permite removê-las. Veja 
no exemplo a seguir a variável resultado declarada, porém não 
utilizada no método Somar : 
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class Program 


{ 


public static int Somar(int a, int b) 


t 


return a ~; 














Remover variável não usada N > | À CS0168 A variável "resultado" está declarada, mas nunca é usada 
Configurar ou Suprimir problemas + 
static void Main(string[] ) í MERENS i 
{ i return a +b; E E: 


} Visualizar alterações 


Corrigir todas as ocorrências em: Documento | Projeto | Solução 


Figura 11.21: Removendo variáveis não utilizadas 


Como alternativa à ação rápida, você pode parar com o cursor 
de inserção na linha que contém a variável não usada e teclar Ctrl 
+ x para excluí-la. 


11.10 CONVERTENDO STRING.FORMAT EM 
STRING INTERPOLADA 


Ao efetuarmos manutenções em código legado, por vezes 
esbarramos com o uso do método Format da classe string para 
a montagem de cadeias de caracteres complexas. Essa era a forma 
recomendada para a montagem de strings antes da linguagem 
passar a suportar a interpolação de strings abordada no capítulo 1 
deste livro. 


O Visual Studio 2017 e versões posteriores oferecem uma ação 

rápida que permite converter o código montado com o método 

Format em uma string interpolada. Para testar o recurso, vamos 
partir do exemplo a seguir: 


using System; 
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namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
string titulo = "Produtividade em C#"; 
string autor = "Cláudio Ralha"; 
string editora = "Casa do Código"; 


string mensagem = string.Format ("Obrigado por adquiri 
ro livro {0}; escrito por (1) e publicado pela editora (2)", tit 
ulo, autor, editora); 

Console.wWriteLine(mensagem); 


Para testar a refatoração, clique com o botão direito do mouse 
sobre o método Format e selecione a ação rápida Converter para 
cadeia de caracteres interpolada. 


7 = static void Main(string[] args) 


8 { 

9 string titulo = "Produtividade em C#"; 

10 string autor = “Cláudio Ralha"; 

11 string editora = “Casa do Código"; 

1g - | string mensagem = string.Format("Obrigado por adquirir o livro (0), escrito por 











q Converter para cadeia de caracteres interpolada | > 
4 


i eee r , | string editora = "Casa do Código"; 
T etpararensaeuména: string mensagem = Obrigado por adquirir o livro {ff}, escrito por 
qg Desencapsular e recuar todos os argumentos string mensagem = "Obrigado por adquirir o livro (Fituld), escrito por 


Console.WriteLine(mensagem); 





Encapsular a lista de argumentos longa + 


Visualizar alterações 


Figura 11.22: Substituindo string.Format por uma string interpolada 


Como resultado, você obterá a seguinte string interpolada: 


string mensagem = $"Obrigado por adquirir o livro (titulo), escri 
to por (autor) e publicado pela editora (editora)"; 
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11.11 CONVERTENDO UM LOOP FOR EM UM 
LOOP FOREACH 


Há casos em que desejamos simplificar o código, 
transformando um laço for em um laço foreach . Para cenários 
em que o loop for contém todas as três partes (inicializador, 
condição e iterador), o Visual Studio oferece a ação rápida 
Converter em foreach. 


Para ilustrar como usar essa ação, vamos partir do exemplo a 
seguir: 


using System; 
using System.Collections.Generic; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
var pessoas = new List<string>() {"Cláudio", "Flávia", 
"Iara"}; 
for (int i = O; i < pessoas.Count; i++) 
{ 
Console.writeLine(pessoas[i]); 
3 
3 
3 
3 


Ao examinar o código, note que o laço for contém todas as 
três partes e que a variável de controle do laço é usada apenas para 
iterar pelos itens, ou seja, este é um laço que pode ser simplificado. 
Para aplicar a ação, clique com o botão direito do mouse sobre a 
palavra-chave for e selecione no menu de ações rápidas a opção 
Converter em foreach. Veja: 
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8 - static void Main(string[] args) 


9 { 
10 var pessoas = new List<string>() {"Cláudio","Flávia","Iara"}; 
gd. for (int i = 0; i < pessoas.Count; i++) 
1 Converter em 'foreach' Es 
15 var pessoas = new List<string>() ("Cláudio","Flávia","Iara"); 
14 
foreach (string v in pessoas) 
15 { 
16 } 


17 } Console.WriteLine E 
18 $ Console.WriteLine(M); 
Visualizar alterações 


Figura 11.23: Convertendo um laço for em laço foreach 


Após converter o laço for em laço foreach , a ferramenta 
Renomear será exibida para que possamos atribuir um nome 
significativo à variável de controle do loop. Neste exemplo, 
utilizamos pessoa . Confira o resultado final da conversão na 
próxima listagem: 


using System; 
using System.Collections.Generic; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
var pessoas = new List<string>() {"Cláudio", "Flávia", 
"Iara"}; 
foreach (string pessoa in pessoas) 
{ 
Console.WriteLine(pessoa); 
3 
3 
3 
J} 
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11.12 CONVERTENDO UM LOOP FOREACH 


EM UM LOOP FOR 


Em alguns cenários, pode ser necessário efetuar o caminho 


inverso que fizemos na seção anterior, ou seja, converter um loop 
foreach em um loop for . Para ilustrar essa possibilidade, 


podemos utilizar o próprio código gerado anteriormente. 


Para aplicar a ação, clique com o botão direito do mouse sobre 


a palavra-chave foreach e selecione no menu de ações rápidas a 


opção Converter em for. Veja: 


6 a class Program 


7 l 

8 = static void Main(string[] args) 

9 { 

10 var pessoas = new List<string>() {"Cláudio","Flávia","Iara"}; 
gd. foreach (string pessoa in pessoas) 





Converter em for' [+] 


3 Ea F var pessoas = new List<string> "Cláudio", "Flávia", "Iara"}; 
| Usar o tipo implícito fz E ES E Q KI a 2 E 





for (int i = @; i < pessoas.Count; i++) 


d 
16 } 
17 } string pessoa = pessoas[i];| 
18 } Console.WriteLine(pessoa); 


Visualizar alterações 


Figura 11.24: Convertendo um laço foreach em laço for 


Confira na listagem a seguir o resultado da conversão: 


using System; 
using System.Collections.Generic; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


£ 


static void Main(string[] args) 
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var pessoas = new List<string>() {"Cláudio", "Flávia", 


“lara” ) 
for (int i = 0; i < pessoas.Count; i++) 
{ 
string pessoa = pessoas[i]; 
Console.writeLine(pessoa); 
3 
3 
3 
3 


11.13 CONVERTENDO UM LOOP FOREACH 
EM LINQ OU EXPRESSÕES LAMBDA 


Um dos refactorings rápidos introduzidos no Visual Studio 
2019 permite converter um laço foreach em uma consulta LINQ 
ou expressão lambda. Para testar esse recurso, vamos utilizar o 
programa a seguir, que contém um loop foreach no método 
ObterMaiores . Veja: 


using System.Collections.Generic; 


namespace ProdutividadeEmCSharp 


{ 
class Pessoa 
{ 
public string Nome { get; set; } 
public int Idade { get; set; } 
public char Genero { get; set; } 
3 


class Program 


{ 


public static IEnumerable<Pessoa> ObterMaiores(List<Pesso 
a> pessoas) 


{ 


foreach (Pessoa pessoa in pessoas) 


{ 
if (pessoa.Idade >=18) 
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yield return pessoa; 


3 
yield break; 
3 
static void Main(string[] args) 
{ 
List<Pessoa> pessoas = new List<Pessoa>() 
{ 
new Pessoa(){Nome = "Pedro", Idade = 16, Genero = 
™'}, 
new Pessoa(){Nome = "Paulo", Idade = 18, Genero = 
'M'3 
new Pessoa()(Nome = "Marcela", Idade = 16, Genero 
— ES 
new Pessoa()(Nome = "Roberta", Idade = 21, Genero 
— 'F"} 
new Pessoa(){Nome = "Ricardo", Idade = 19, Genero 
— 'M'} 
new Pessoa(){Nome = "Sofia", Idade = 14, Genero = 
'F'}, 
new Pessoa(){Nome = "Vanessa", Idade = 22, Genero 
— ES 
new Pessoa()(Nome = "Rodrigo", Idade = 20, Genero 
— 'M'} 
new Pessoa(){Nome = "Rebeca", Idade = 25, Genero 
— 'F'} 
new Pessoa(){Nome = "Henrique", Idade = 13, Gener 
o — 'M'} 
new Pessoa(){Nome = "Pâmela", Idade = 21, Genero 
— 'F'} 
new Pessoa(){Nome = "Alessandra", Idade = 19, Gen 
ero = 'F' } 
3; 
IEnumerable<Pessoa> maiores = ObterMaiores(pessoas); 
3 
3 
} 


Para converter o trecho do código do loop em uma expressão 
LINQ, execute os seguintes passos: 


1. Clique com o botão direito do mouse sobre a palavra-chave 
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foreach e selecione no menu de contexto a opção Ações 
Rápidas e Refatorações. 
2. O menu de ações rápidas será exibido. Selecione a opção 
Converter para LINQ. 
14 E public k IEnumerable<Pessoa> ObterMaiores(List<Pessoa> pessoas) 


15 { 
16d «2 foreach (Pessoa pessoa in pessoas) 


14 Converter para LINQ [+] using System.Collections.Generic; 
using System.Ling; 


14 Converter para LINQ (formulário de chamada) 


Converter em 'for' 





2€ 
21 Usar o tipo implícito 
22 | 3 
23 
O referências 
24 E static void Main(s; 
25 £ re ssoa pessoa in pessoas 
26 E List<Pessoa> pi pessoa. Idade >= 18 
27 | 1 i pessoa; 
28 new Pessoa) 
29 new Pessoa 
30 new Pessoa Visualizar alterações 
31 new Pessoatyqnuume = noverca , 1uaue = zi, venero = r f3 
32 new Pessoa(){Nome = "Ricardo", Idade = 19, Genero = 'M'}, 
33 new Pessoa(){Nome = "Sofia", Idade = 14, Genero = 'F'}, 


Figura 11.25: Convertendo um loop foreach em uma consulta LINQ 


Após a conversão, o método ObterMaiores ficará como 
mostrado no trecho de código a seguir: 
public static IEnumerable<Pessoa> ObterMaiores(List<Pessoa> pesso 


as) 


{ 


return from Pessoa pessoa in pessoas 
where pessoa. Idade >= 18 
select pessoa; 


Caso você prefira utilizar uma expressão lambda em vez do 
loop foreach , utilize a opção Converter para LINQ (formulário 
de chamada) do menu de ações rápidas. O resultado pode ser visto 
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no próximo fragmento de código: 


public static IEnumerable<Pessoa> ObterMaiores(List<Pessoa> pesso 
as) 


{ 
return pessoas.where(pessoa => pessoa. Idade >= 18).Select(pes 
soa => pessoa); 


3 


11.14 CONVERTENDO ESTRUTURAS 
CONDICIONAIS IF EM SWITCH 


Estruturas condicionais if podem se tornar bastante 
complexas e difíceis de compreender quando são compostas de 
várias cláusulas else if . Com as melhorias introduzidas no Cf 
7.0, tornou-se simples aplicar instruções switch para substituí- 
las na maioria dos cenários. 


Para ilustrar como efetuar essa transformação usando uma 
ação rápida, vamos partir do exemplo a seguir: 
using System; 
namespace ProdutividadeEmCSharp 
{ 
abstract class Funcionario 


{ 
} 


class Vendedor :Funcionario 


{ 
} 


class Supervisor : Funcionario 


{ 
} 
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class Gerente : Funcionario 


{ 
3 
class Program 
{ 
static void Apresentarse(Funcionario funcionario) 
{ 
if (funcionario is Vendedor) 
{ 
Console.WriteLine("Eu sou um vendedor."); 
3 
else if (funcionario is Supervisor) 
{ 
Console.writeLine("Eu sou um supervisor."); 
3 
else if (funcionario is Gerente) 
{ 
Console.writeLine("Eu sou um gerente."); 
3 
3 
static void Main(string[] args) 
{ 
Gerente gerente = new Gerente(); 
Apresentarse(gerente); 
3 
3 


Para aplicar a transformação, clique com o botão direito do 
mouse sobre a palavra-chave if e selecione no menu de ações 
rápidas a opção Converter em Switch: 
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| 1 referência 
27 i static void Apresentarse(Funcionario funcionario) 





{ 
284 - E if (funcionario is Vendedor) 





} Visualizar alterações 


Figura 11.26: Convertendo uma instrução if em switch 





Confira a seguir o código do método Apresentarse após a 


aplicação da ação: 


static void Apresentarse(Funcionario funcionario) 
{ 
switch (funcionario) 
{ 
case Vendedor _ 
Console.writeLine("Eu sou um vendedor."); 
break; 
case Supervisor _ 
Console.writeLine("Eu sou um supervisor."); 
break; 
case Gerente _ 
Console.writeLine("Eu sou um gerente."); 
break; 
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11.15 ADICIONANDO CLÁUSULAS CASE 
AUSENTES EM UM SWITCH 


Ao criarmos uma estrutura condicional switch no Visual 
Studio, normalmente utilizamos o code snippet, que gera 
automaticamente e sempre que possível os blocos case 
adequados para o tipo de dado que está sendo avaliado. Veja a 
seguir um exemplo: 


namespace ProdutividadeEmCSharp 


{ 
enum EstadoCivil 
{ 
Solteiro, 
Casado 
} 
class Program 
{ 
static void Main(string[] args) 
{ 
var estadoCivil = EstadoCivil.Casado; 
switch (estadoCivil) 
{ 
case EstadoCivil.Solteiro: 
break; 
case EstadoCivil.Casado: 
break; 
default: 
break; 
) 
} 
} 
} 


No mundo real, nem sempre saberemos todos os estados 
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possíveis de um tipo enumerado em um primeiro momento, e 
pode ser necessário adicionar novas constantes para o tipo 
posteriormente. Exemplo: 


enum EstadoCivil 


{ 


Solteiro, 
Casado, 
UniaoEstavel, 
Divorciado, 
Separado, 
Viuvo 


Para casos como esse, o Visual Studio 2017 e posterior oferece 
uma ação rápida que nos permite incluir de forma automática 
cláusulas case para as constantes ausentes. Veja: 


16 = static void Main(string[] args) 


17 { 

18 var estadoCivil = EstadoCivil.Casado; 

19 

26 O ~: switch (estadoCivil) 

21HEE 

2% Adicionar casos ausentes N [+] i IDE0010 Popular comutador 

Configurar ou Suprimir problemas » 

E break; 

24 cas case EstadoCivil.UniaoEstavel: 

25 break; 

26 def case EstadoCivil.Divorciado: 
break; 

27 case EstadoCivil.Separado: 

28 break; 

29 } case EstadoCivil.Viuvo: 
break; 

30 } default: 

31 T ri 


Visualizar alterações 


Corrigir todas as ocorrências em: Documento | Projeto | Solução 


Figura 11.27: Adicionando cases ausentes em um switch 


Após a aplicação da ação, a instrução switch ficará conforme 
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mostrado na listagem a seguir: 


switch (estadoCivil) 
{ 
case EstadoCivil.Solteiro: 
break; 
case EstadoCivil.Casado: 
break; 
case EstadoCivil.UniaoEstavel: 
break; 
case EstadoCivil.Divorciado: 
break; 
case EstadoCivil.Separado: 
break; 
case EstadoCivil.Viuvo: 
break; 
default: 
break; 


11.16 UTILIZANDO INICIALIZADORES DE 
OBJETOS 


O Visual Studio 2017 e superior inclui uma ação rápida que 
permite usar inicializadores de objetos em vez de invocar o 
construtor e ter linhas adicionais de instruções de atribuição. 
Vamos ilustrar esse cenário através do exemplo a seguir: 


namespace ProdutividadeEmCSharp 


{ 


class Pessoa 


{ 
public string Nome { get; set; } 
public int Idade { get; set; } 
public char Genero { get; set; } 


} 


class Program 


{ 


static void Main(string[] args) 


{ 
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var pessoa = new Pessoa(); 


pessoa.Nome = "Fernando"; 
pessoa. Idade = 37; 
pessoa.Genero = 'M'; 


Para executar esta ação, clique com o botão direito do mouse 
sobre a palavra-chave new e selecione no menu de ações rápidas a 
opção A inicialização do objeto pode ser simplificada. Veja: 


14 = static void Main(string[] args) 














15 $ 

1€ O ~ var pessoa = new Pessoa(); 

1) pH z ESSE z 

é A inicialização do objeto pode ser simplificada DS * | O iDe0017 A inicialização do objeto pode ser simplificada 


1º Introduzir local para "new Pessoa()" 
introduzir local para todas as ocorrências de "new Pessoa 
Introduzir local para tod de "new Pessoa0" 1 


2¢ var pessoa = new Pesso 

21 Configurar ou Suprimir problemas + = aS 
dade = 3 

22 l } nero = 'M'; 


E 
i] 
À 
Nome = *Fernando"f] 
Idade = 37] 


Genero = 'M 
È 


} 


Visualizar alterações 


Corrigir todas as ocorrências em: Documento | Projeto | Solução 


Figura 11.28: Simplificando a inicialização de um objeto 


Após a aplicação da ação, obteremos o seguinte resultado: 


var pessoa = new Pessoa 


{ 
Nome = "Fernando", 
Idade = 37, 
Genero = 'M' 

3; 
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11.17 UTILIZANDO INICIALIZADORES DE 
COLEÇÕES 


O Visual Studio 2017 e superior também inclui uma ação 
rápida que permite usar inicializadores de coleções para simplificar 
o nosso código. Observe o exemplo a seguir: 


using System.Collections.Generic; 


namespace ProdutividadeEmCSharp 
{ 
class Program 
{ 
static void Main(string[] args) 
{ 
var primos = new List<int>(); 
primos.Add(2); 
primos.Add(3); 
primos.Add(5); 
primos.Add(7); 
primos .Add(11); 
primos .Add(13); 
primos .Add(17); 
primos .Add(19); 


Para executar esta ação, clique com o botão direito do mouse 
sobre a palavra-chave new e selecione no menu de ações rápidas a 
opção A inicialização de coleção pode ser simplificada. Veja: 
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| O referências 
7 E static void Main(string[] args) 
8 | f 
9 - var primos = new List<int>(); 





16 pe E 
) A inicialização de coleção pode ser simplificada N L] @ IDE0028 A inicialização de coleção pode ser simplificada 


- Introduzir local para "new List<int>()" 








1: Introduzir local para todas as ocorrências de "new List<int>()" 


14 Configurar ou Suprimir problemas » 
15 primos .Add(13); 

16 primos. Add(17); 

17 primos .Add(19); 

18 } 

19 } 

20 F 


Visualizar alterações 
Corrigir todas as ocorrências em: Documento | Projeto | Solução 


Figura 11.29: Simplificando a inicialização de uma coleção de inteiros 


Após a aplicação da ação, o código-fonte do nosso programa 
de teste ficará como mostrado na próxima listagem: 


using System.Collections.Generic; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
£ 
var primos = new List<int> 
{ 
2, 
3, 
5, 
7, 
11, 
13, 
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19 
J}; 


Veja agora um segundo exemplo no qual temos uma coleção 
pessoas composta de uma lista de objetos do tipo Pessoa : 


using System.Collections.Generic; 


namespace ProdutividadeEmCSharp 


{ 
class Pessoa 
{ 
public string Nome { get; set; } 
public int Idade { get; set; } 
public char Genero { get; set; } 
} 
class Program 
{ 
static void Main(string[] args) 
{ 
var pessoal = new Pessoa 
{ 
Nome = "Renan", 
Idade = 35, 
Genero = 'M' 
Fi 
var pessoa2 = new Pessoa 
{ 
Nome = "Cristiane", 
Idade = 43, 
Genero = 'F' 
Fi 
var pessoas = new List<Pessoa>(); 
pessoas.Add(pessoal); 
pessoas.Add(pessoa2); 
) 
} 
} 


Clique novamente com o botão direito do mouse sobre a 
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palavra-chave new e selecione no menu de ações rápidas a opção 


A inicialização de coleção pode ser simplificada. Veja: 


using System.Collections.Generic; 


n 


{ 


static void Main(string[] args) 


13 E 

14 { 

15 E var pessoal = new Pessoa 
16 { 

17 Nome = “Renan”, 

18 Idade = 35, 

19 Genero = 'M' 

20 J; 

21 E var pessoa2 = new Pessoa 
22 E! 

23 Nome = “Cristiane”, 
24 Idade = 43, 

25 Genero = 'F' 

26 3 

210 ~ var pessoas = new List<Pessoa>(); 


o! A inicialização de coleção pode ser simplificada N 
ši Introduzir local para "new List<Pessoa>()" 
31 Introduzir local para todas as ocorrências de "new List<Pessoa> ()" 


37 Configurar ou Suprimir problemas » 





L] O iDeoozs A inicialização de coleção pode ser simplificada 


l 
var pessoas = new Listepessoa 
ssoa! 
ssoa2)); 
var pessoas = new List<Pessoa> 


il 
E pessoaif] 


pessoa2 


Visualizar alterações 


Corrigir todas as ocorrências em: Documento | Projeto | Solução 


Figura 11.30: Simplificando a inicialização de uma lista de objetos do tipo Pessoa 


Confira o resultado a seguir: 


amespace ProdutividadeEmCSharp 


class Pessoa 


£ 


public string Nome { get; set; } 
public int Idade { get; set; } 
public char Genero { get; set; } 


} 


class Program 


{ 
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static void Main(string[] args) 


{ 
var pessoal = new Pessoa 
{ 
Nome = "Renan", 
Idade = 35, 
Genero = 'M' 
>; 
var pessoa? = new Pessoa 
{ 
Nome = "Cristiane", 
Idade = 43, 
Genero = 'F' 
7; 
var pessoas = new List<Pessoa> 
{ 
pessoa1, 
pessoa2 
7; 
} 


Conforme você pode observar, o resultado é realmente melhor 
do que o que tínhamos antes da ação, mas acredito que você 
também gostaria que a ferramenta fornecesse como saída o trecho 
de código mostrado na próxima listagem: 


var pessoas = new List<Pessoa> 
{ 
new Pessoa { 
Nome = "Renan", 
Idade = 35, 
Genero = 'M' 
} 
new Pessoa { 
Nome = "Cristiane", 
Idade = 43, 
Genero = 'F' 


H; 


Infelizmente, essa ação ainda não oferece um resultado tão 
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avançado como o esperado. Quem sabe isso já tenha mudado 
quando você estiver lendo este livro. 


Com o que você aprendeu neste capítulo, não há mais motivos 
para entregar ou aceitar código mal escrito, uma vez que o Visual 
Studio é capaz de sinalizar e corrigir rapidamente boa parte do 
código que pode ser melhorado e formatado segundo as regras de 
estilo que definirmos ou simplificarmos. 


Parodiando aquela consagrada escola inglesa para bruxos, eu 
costumo brincar que o conhecimento reunido neste livro é como 
as aulas de "Defesa contra as Artes das Trevas" que ajudam a nos 
proteger de pessoas que acham que fazemos mágica em vez de 
software e que não entendem que consertar código malfeito ou 
remover funcionalidades desnecessárias também consome um 
bom tempo de um ou mais sprints do Scrum. 
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CaríruLo 12 


DEPURAÇÃO 


A depuração é o processo que usamos para encontrar erros em 
um projeto. Para executá-la, recorremos normalmente à depuração 
interativa, que é feita anexando o depurador a um processo em 
execução e investigando a execução e o estado do programa com 
um vasto arsenal de ferramentas de depuração oferecidas pelo 
Visual Studio. 


Não há mágica, nem bala de prata quando o assunto é 
depuração. Depurar é um processo cansativo, moroso e cheio de 
obstáculos, principalmente quando o código não foi otimizado 
para a depuração e não se conhece a fundo as ferramentas de 
depuração oferecidas pelo ambiente de desenvolvimento. 


O domínio dos recursos do depurador do Visual Studio é vital 
para quem busca produtividade, pois reduz de forma significativa 
o tempo gasto com a depuração, além de transformar você em um 
desenvolvedor ou desenvolvedora mais eficaz. 


Em muitos casos, alguns minutos percorrendo o código com o 
depurador serão suficientes para encontrar e solucionar o bug. 
Quando isso não for o bastante, será necessário recorrer a outras 
frentes como investigar logs, analisar despejos, efetuar testes de 
unidade, criação de perfil etc. 
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Preparamos este capítulo para todos que já sofreram e ainda 
sofrem depurando código alheio. Ao longo das próximas páginas, 
iniciaremos o nosso estudo abordando os vários tipos de pontos de 
interrupção suportados pelo Visual Studio, incluindo pontos de 
interrupção condicionais, tracepoints, pontos de interrupção de 
função e os novos pontos de interrupção de dados suportados 
apenas no .NET Core 3.0 ou superior. Veremos também como 
compartilhar pontos de interrupção com outros desenvolvedores 
usando os recursos de exportação e importação de pontos de 
interrupção. 


Após dominarmos os pontos de interrupção, veremos como 
navegar pelo código em modo de depuração e como usar o recurso 
Editar e Continuar suportado pela linguagem Cf. 


O capítulo termina abordando como visualizar e alterar dados 
usando várias janelas de depuração incluídas no Visual Studio. 
Veremos como tirar proveito das janelas Saída, Imediata, Locais, 
Automáticos, Inspeção, Inspeção Rápida e como usar DataTips de 
forma eficiente. Abordaremos também como | utilizar 
visualizadores de depuração nativos do Visual Studio para 
visualizar dados no formato JSON, XML, Datasets etc., como 
baixar visualizadores extras a partir do Visual Studio Marketplace 
e o que é necessário para criar seus próprios visualizadores de 
depuração. 


12.1 FORÇANDO O MODO DE INTERRUPÇÃO 
DO DEPURADOR 


Antes de iniciarmos a depuração, normalmente definimos 
pontos de interrupção em nosso código, o que faz com que o 
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programa seja pausado em uma linha de código específica quando 
a execução atinge o ponto sinalizado. Em termos práticos, isso 
significa que todos os threads em execução são pausados na linha 
de código em questão. 


Esse é o caminho padrão a ser seguido, mas haverá casos em 
que desejaremos entrar nesse modo de interrupção para efetuar a 
depuração mesmo sem termos pontos de interrupção definidos 
previamente. Para tanto, basta clicar no menu Depurar e selecionar 
a opção Pausar Execução ou teclar Ctrl + Alt + Break. Você verá 
que a execução será pausada e uma seta verde será mostrada na 
linha em que a execução parou. Confira: 


w 
I 


class Program 


8 { 

9 

10 = static void Main(string[] args) 

11 { 

12 int total = 0; 

13 je for (int i = 0; i < 100; i++) 

14 { 

15 total += i; 

16 Console.WriteLine(total); 
O 17 1 ffhread.Sleep(1000) ; 

18 } 

19 } 

20 } 

21 } 


Figura 12.1: Forçando a entrada no modo de interrupção do Visual Studio 


A partir deste ponto, você pode usar as opções de navegação 
pelo código descritas em detalhes na seção Navegando pelo código 
em modo de interrupção deste capítulo. 
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12.2 DEFININDO PONTOS DE INTERRUPÇÃO 
NO SEU CÓDIGO 


O Visual Studio nos permite definir pontos de interrupção (em 
inglês, breakpoints) em qualquer linha de código executável. Isso 
nos possibilita pausar a execução do depurador onde desejarmos. 


Para definir um ponto de interrupção no código-fonte com o 
mínimo de esforço, basta parar com o cursor de inserção na linha 
desejada e teclar F9 ou clicar com o botão esquerdo do mouse na 
margem da extrema esquerda, ao lado de uma linha de código. O 
ponto de interrupção será exibido como um círculo vermelho na 
margem esquerda. Ao teclar F9 novamente ou clicar uma segunda 
vez com o mouse, o ponto será desmarcado. 


O Visual Studio suporta diferentes tipos de pontos de 
interrupção em Cf: 


e Pontos de interrupção simples. 

e Pontos de interrupção condicionais. 
e Pontos de interrupção de dados. 

e Pontos de interrupção de funções. 

e Tracepoints. 


O gerenciamento de todos os pontos de interrupção é feito 
através da janela Pontos de Interrupção. Para exibi-la, clique no 
menu Depurar, depois no submenu Janelas e, por fim, na opção 
Pontos de Interrupção ou simplesmente tecle Ctrl + D, B. A janela 
será exibida com a lista de pontos de interrupção ativos e 
desabilitados. Veja: 
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Pontos de Interrupção 


liñ ES 





Novo~ X 2p é eG = Mostrar Colunas - Pesquisar: ~ NaColuna: Todas visíveis 
Nome Rótulos Condição Contagem de Ocorrências 
MM) J Program.cs, linha 47 caractere 13 sempre interromper 
O 'Pr am sempre interromper 














Figura 12.2: Janela de gerenciamento de pontos de interrupção do Visual Studio 


Os pontos de interrupção ativos aparecem com círculos 
vermelhos cheios, enquanto os desabilitados são mostrados com 
círculos vazios tanto na margem esquerda do editor quanto na 
janela Pontos de Interrupção. Os tracepoints são sinalizados com 
losangos. 


Para que os pontos de interrupção estejam disponíveis, o 
código do nosso projeto precisa ser compilado em modo debug. 
Isso é feito selecionando a opção Debug na barra de botões do 
Visual Studio. 


o9 Arquivo Editar Exibir Projeto Compilação Depurar Teste Análise Ferramentas Extensões 
O- B- Hd 9- [petus F Any CPU - Pp ProdutividadeEmCSharp ~ jë 


Figura 12.3: Selecionando a compilação em modo debug 


Nos próximos tópicos, veremos como tirar proveito de cada 
um dos tipos de pontos de interrupção suportados. 


Exportando e importando pontos de interrupção 


O Visual Studio nos permite compartilhar o estado e o local 
dos pontos de interrupção com outros desenvolvedores. Para isso, 
basta exportar um ou mais pontos de interrupção para um arquivo 
XML e importá-los em outro computador que esteja rodando a 
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IDE. 


Note que essas funcionalidades nos possibilitam partilhar um 
ponto de interrupção específico, um conjunto deles que atenda aos 
critérios de pesquisa informados na janela de gerenciamento ou, se 
preferir, a relação completa de pontos de interrupção criados pelo 
desenvolvedor. 


Para exportar um ou mais pontos de interrupção a partir da 
janela de pontos de interrupção, selecione as caixas de verificação 
correspondentes e, a seguir, clique com o botão direito do mouse 
em um deles. Selecione Exportar itens selecionados, escolha um 
local de exportação e, em seguida, selecione salvar. Se quiser salvar 
todos, clique no ícone Exportar todos os pontos de interrupção na 
barra de botões. 


Para importá-los, selecione o ícone importar pontos de 
interrupção de um arquivo, navegue até o local do arquivo XML e 
selecione Abrir. Veja: 


Pontos de Interrupção 





Novor X Pé EG E Mostrar Colunas - Pesquisar: ~ NaColuna: Todasvisíveis ~ E 
q 


Nome A à Rótulos Condição Contagem de Ocorrências 











sempre interromper 





Importar pontos de interrupção 


4 
q 


4 
Exportar todos os pontos de interrupção 


Figura 12.4: Recursos de exportação e importação de pontos de interrupção do Visual Studio 


Desativando temporariamente pontos de interrupção 


Apesar de ser fácil e rápido marcar e desmarcar pontos de 
interrupção simples, existirão momentos em que desejaremos 
desativar temporariamente um ou mais pontos em vez de 
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simplesmente excluí-los. Essa alternativa é particularmente útil 
quando desejamos preservar condições incluídas em um ponto de 
interrupção, rótulos associados e tracepoints. 


Para desabilitar um ponto de interrupção sem excluí-lo a partir 
do próprio editor, clique com o botão direito do mouse sobre o 
ponto de interrupção e selecione no menu de contexto a opção 
Desabilitar ponto de interrupção. Para reabilitá-lo, clique 
novamente com o botão direito do mouse sobre ele e selecione 
Habilitar ponto de interrupção. Para obter o mesmo resultado 
usando a janela de gerenciamento de pontos de interrupção, basta 
marcar ou desmarcar a caixa de verificação existente junto a cada 
ponto listado. 


Atribuindo rótulos a pontos de interrupção 


Durante a depuração de programas com código complexo em 
que se tem vários pontos de interrupção definidos, pode ser 
produtivo atribuir rótulos a cada um deles. 


A atribuição dos rótulos pode ser feita tanto através do editor 
quanto da janela de gerenciamento de pontos de interrupção. Em 
ambos os casos, basta executar os seguintes passos: 


1. Clique com o botão direito do mouse sobre o ponto de 
interrupção. No menu de contexto que será exibido, 
selecione Editar rótulos. 

2. A caixa de diálogo Editar rótulos de ponto de interrupção será 
exibida. Forneça um rótulo para o ponto de interrupção no 
campo Digite um novo rótulo e a seguir clique no botão OK. 
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Editar rótulos de ponto de interrupção x 


Digite um novo rótulo: 





Aqui mora o bug :) Adicionar 








Ou escolha entre os rótulos existentes: 

















Figura 12.5: Atribuindo um rótulo a um ponto de interrupção 





O rótulo atribuído será exibido na coluna Rótulos. Veja: 





o t x 
Novor X Pe CG F Mostrar Colunas - Pesquisar: - NaColuna: Todas visíveis - E 
Nome Rótulos Condição Contagem de Ocorrências 

MO Program.cs, linha 47 caractere 13 sempre interromper 
MO Seene Aqui mora o bug:) sempre interromper 


Figura 12.6: Rótulo do ponto de interrupção sendo exibido na janela de gerenciamento de 
pontos de interrupção 


Qualquer pessoa que já tenha mudado de residência sabe a 
importância de colocar identificadores nas caixas para que seja 
possível encontrar algo rapidamente quando necessário. 


Observe que existe um campo Pesquisar na janela Pontos de 
Interrupção que nos permite filtrar os breakpoints existentes. Se 
digitarmos bug seguido de Enter nesse campo de busca, veremos 
que será exibido apenas um ponto de interrupção que contém esta 
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palavra em seu rótulo. Confira: 


Pontos de Interrupção 





x 
Novo” X p é eG €E Mostrar Colunas ~ Pesquisar: bug ~ Na Coluna: Todas visíveis - = 


Nome Rótulos Condição Contagem de Ocorrências 














He A ES ERC CTIE] Aqui mora o bug :) sempre interromper 





Figura 12.7: Filtrando os pontos de interrupção da janela de gerenciamento de pontos de 
interrupção 


12.3 UTILIZANDO PONTOS DE 
INTERRUPÇÃO CONDICIONAIS 


Pontos de interrupção condicionais foram criados para 
minimizar o tempo e o esforço mental que dedicamos à depuração. 
O depurador do Visual Studio suporta três opções de condições 
em breakpoints: expressão condicional, filtro e contagem de 
acesso. 


Para ilustrar como utilizá-los em nossos projetos, vamos partir 
de um programa bem simples: 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
int contador = 0; 
for (int i = 0; i <= 10; i++) 
{ 
contador += i; 
} 
} 
} 
) 


Execute os seguintes passos para criar o ponto de interrupção: 
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1. Adicione um ponto de interrupção na linha a seguir: 


contador += i; 


2. Clique com o botão direito do mouse sobre o ponto de 
interrupção e selecione Condições no menu de contexto. Para esse 
teste, desejamos que o ponto só seja ativado quando a variável 
contador for maior que 10 . Para tanto, entre como contador 
> 10 no campo mais à direita da definição da expressão 
condicional e, a seguir, clique no botão Fechar. Veja: 


9 = static void Main(string[] args) 
10 { 
11 int contador = 0; 
12 = for (int i = 0; i <= 10; i++) 
13 { 

Su += i; 


Config. de Ponto de Interrupção X 








Localização: Program.cs, linha: 14, caractere: 17, Deve coincidir com o código-fonte 


























|[Y| Condições 
Expressão Condicional ~ É verdadeiro - contador > 10 Cancelar 
Adicionar condição 
[_] Ações 
Fechar 
15 } 
16 } 
17 } 


[b 


Figura 12.8: Definindo uma condição para a execução de um ponto de interrupção 


3. Note na próxima imagem que o ponto de interrupção 
passou a ser sinalizado por um sinal de mais (+) dentro do círculo 
vermelho, indicando a presença de uma condição: 
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9 = static void Main(string[] args) 
10 { 

11 int contador = 0; 

12 = for (int i = 0; i <= 10; i++) 
13 { 


o u 


15 } 


18 } 
19 


Figura 12.9: Sinalização de um ponto de interrupção condicional 


Ao executar o programa, você verá que na primeira vez em que 
ocorre a parada no ponto de interrupção o contador estará com o 
valor 15. Confira: 


9 = static void Main(string[] args) 
10 { 

11 int contador = 
12 = for (int i = 0; 
13 { 


© 14 bl contador h= i;l 


15 } contador 15 > 


8; 
i <= 10; i+) 


Figura 12.10: Inspecionando o valor da variável contador 


Repare no tempo de depuração que o uso desses pontos de 
interrupção mais inteligentes consegue nos poupar. O depurador 
do Visual Studio suporta o uso de condições para definir pontos de 
interrupção que serão ativados nos seguintes cenários: 


e Uma expressão condicional é avaliada como verdadeira. 
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e O valor de uma expressão condicional se altera. 

e Atingimos uma contagem de acesso definida pelo 
desenvolvedor. 

e Uma condição de filtro configurada para disparar somente 
em dispositivos especificados ou em processos e threads 
especificados. 


Para saber mais sobre pontos de interrupção condicionais, 
consulte: 


https://docs.microsoft.com/pt- 


br/visualstudio/debugger/using-breakpoints?view=vs- 
2019%breakpoint-conditions 





12.4 UTILIZANDO PONTOS DE 
INTERRUPÇÃO DE DADOS 


Em projetos .NET Core 3.0 ou superior, podemos definir 
pontos de interrupção de dados. Esse tipo especial de ponto de 
interrupção interrompe a execução quando uma propriedade de 
um objeto específico é alterada. 


Para ilustrar como explorar esse novo recurso, vamos partir do 
exemplo a seguir: 


using System; 
using System.Threading; 


namespace ProdutividadeEmCSharp 


{ 


class Pessoa 
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public string Nome { get; set; } 
public int Idade { get; set; } 
public char Genero { get; set; } 


3 


class Program 


£ 


static void Main(string[] args) 


{ 


Pessoa pessoa = new Pessoa() { Nome = "Pedro", Idade 
= 18, Genero = 'M' }; 

Console.wWriteLine($"Nome: {pessoa.Nome} Idade: {pess 
oa. Idade)"); 

Thread.Sleep(5000); 

pessoa. Idade = 19; 

Console.ReadLine(); 


Para definir um ponto de interrupção de dados, execute os 
seguintes passos: 


1. Inicie a depuração e aguarde até que um ponto de 
interrupção seja atingido. Para esse exemplo, defina o ponto de 
interrupção na linha a seguir: 

Pessoa pessoa = new Pessoa() { Nome = "Pedro", Idade = 18, Genero 
= 'M' }; 

2. Inspecione o objeto a ser monitorado, em nosso caso 

pessoa , expandindo as suas propriedades na janela Inspeção, 
Automáticos ou Locais. 


3. Clique com o botão direito do mouse na propriedade 
desejada ( Idade ) e selecione no menu de contexto a opção 
Interromper quando o valor é alterado. 
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Arquivo Editar Exibir Projeto Compilação Depurar Teste Análise Ferramentas Extensões | O) Prodhap - O x 
Janela Ajuda 

































or -BBd|9-Ç-|[Debug -| [Any cu b Continuar = F [8]. DO 91000 Q lveshe F 
Program.cs +» X .8 
[E ProdutividadeEmCSharp =| *% ProdutividadeEmCSharp.Program - | Pa Main(stringl] args) -| 8 

Senni +g 
u public int Idade { get; set; } Pa 
1 referência A 
12 public char Genero { get; set; } I g 
13 Q 
g 
14 EI 
15 E 
16 B 
17 
ou 
” 19 Console Line 
20 Thread.Sleep(5000); 
21 pessoa. Idade = 19; e 
22 Console.Readtine(); EF. Copiar Ohie 
23 } É) Colar Ctrl+V ne 
100% =] © Näo foi encontrado nenhum problema | Editar Valor ln:19 Carl3 SPC CRLF 
Pesquisar (Ctrl+E) P- Profundida $ Adicionar Inspeção 
Nome Valo é Adicionar Inspeção Paralela Wo 
Excluir Inspeção ProdutividadeEmCSharp.... 
Selecionar Tudo Ctri+A dr 





E Limpar Tudo 


# Nome "Ped = 
Adicionar item para assistir Interromper Quando o Valor é Alterado | 


Q ~ string 


A Fixar Membro como Favorito 
Exibição Hexadecimal 
4º Recolher Pai 


É Ir para Desmontagem 





Figura 12.11: Definindo um ponto de interrupção de dados 


A propriedade é sinalizada com um ponto de interrupção. 


Veja: 





In ção 1 
Pesquisar (Ctrl+ E) P- Profundidade de Pesquisa: 3 ~ y A 
Nome Valor Tipo 
4 @ pessoa {ProdutividadeEmCSharp.Pessoa} {$1} ProdutividadeEmCSh... 
# Genero TI'M' char 





OO ade 
# Nome "Pedro" Q ~ string 
Adicionar item para assistir 


Figura 12.12: Sinalização de um ponto de interrupção de dados na janela de Inspeção 


4. Tecle F5 para continuar a execução e aguarde até que a 
execução pare na linha que altera o valor da propriedade Idade . 
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Observe que os valores anterior e atual são exibidos: 








Arquivo Editar Exibir Projeto Compilação Depurar Formatar Layout Teste pequi. O Produhap  — o x 
Imagem Análise Ferramentas Extensões Janela Ajuda 
©- SW D- > Continuar ~ 5d [A m| DD Qlveshre E 
a 
zé 
[E] ProdutividadeEmCSharp ~ ^$, ProdutividadeEmCSharp.Pessoa - # Idade -A 
+38 
$ u public int Idade { get; set; ) 4) a g 
A q 
12 public char Genero { get; set; | Ponto de Interrupção de Dados Atingido 1x I e 
13 } i 5, 
s Í O ponto de interrupção a seguir foi atingido: E) 
14 = class Program — 
a5 { | Quando Idade em $1 (ProdutividadeEmCSharp.Pessoa) altera de 
O a n no processo “ProdutividadeEmCSharp.exe" 
16 = static void Main(string[] args)! a 
17 { i 


Valor Anterior: 18 (int) 





“us EEE EEE valor Atual: 19 (int) 
19 Conscle.WriteLine($"Nome: ( 
20 Thread.Sleep(5000); H 
21 pessoa.Idade = 19; 
22 Console.ReadLine(); 
23 } 
24 } 
25 } 
26 
100% =! © Nāo foi encontrado nenhum problema | Fv 4 > Um1l Car33 SPC CRLF 
Inspeção 1 EEK 
Pesquisar (Ctrl+ E P- Profundidade de Pesquisa: 3 - TA 
Nome Valor Tipo 
4 @ pessoa {ProdutividadeEmCSharp.Pessoa} {$ © ProdutividadeEmCShar 
# o T7'M G char 
O Idade 18 G int 
Pedro 6 string 





4 Adicionar ao Controle do Código-Fonte © gy 





Figura 12.13: Execução parada em um ponto de interrupção de dados 


Quando bem utilizado, esse recurso pode reduzir 
consideravelmente o tempo de depuração de um projeto. Vale 
destacar que esse tipo de ponto de interrupção tem algumas 
limitações, além de só estar disponível no Visual Studio 2019 para 
projetos .NET Core 3.0 ou superior. Segundo a documentação 
oficial, os pontos de interrupção de dados não funcionarão para: 


e Propriedades que não são expansíveis na dica de 
ferramenta ou nas janelas Inspeção, Locais e Automáticos. 

e Variáveis estáticas. 

e Classes com o atributo DebuggerTypeProxy . 
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e Campos dentro de structs. 


Para saber como proceder nesses casos, consulte a seguinte 
página de resolução de problemas da documentação oficial: 


https://docs.microsoft.com/pt- 


br/visualstudio/debugger/troubleshoot-data-breakpoint- 
errors?view=vs-2019 





12.5 UTILIZANDO PONTOS DE 
INTERRUPÇÃO DE FUNÇÃO 


Pontos de interrupção de função são usados quando desejamos 
interromper a execução sempre que uma função é chamada. 
Imagine, por exemplo, que você sabe o nome da função, mas não a 
sua localização ou que existem várias funções com o mesmo nome 
(leia-se métodos sobrecarregados) e deseja parar a execução em 
todas as chamadas. 


Para ilustrar como utilizar esse tipo de ponto de interrupção, 
vamos utilizar o seguinte programa de teste: 


using System; 
using System.Threading; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


{ 


static void Escrever() 


{ 
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Console.writeLine("Executando método Escrever()"); 


static void Escrever(string mensagem) 


{ 


Console.WwriteLine("Executando método Escrever (string 
mensagem)"); 


3 


static void Main(string[] args) 


{ 
Escrever (); 
Thread.Sleep(5000); 
Escrever ("Produtividade em C#"); 
Console.ReadLine(); 
3 


Para definir um ponto de interrupção de função, execute os 
seguintes passos: 


1. No menu Depurar, selecione o submenu Novo ponto de 
interrupção e, a seguir, a opção Ponto de interrupção de função. 
Esta opção também está disponível na janela Pontos de 
Interrupção. Nesse caso, você deve clicar em Novo e selecionar a 
opção Ponto de interrupção de função. 


2. A caixa de diálogo Novo ponto de interrupção de função será 
exibida. Digite o nome da função Escrever no campo Nome da 
função. 
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Novo ponto de interrupção de função ? x 


Interromper qualquer função que corresponda ao nome de função especificado e identificado durante a depuração 





Nome da função: [Escrever ] (D Linguagem: Cë € 





Condições 














Ações 











Cancelar 


Figura 12.14: Definindo um ponto de interrupção de função 





3. Note que é possível ainda definir condições e ações, se assim 
você desejar. Na janela Pontos de Interrupção, o ponto de 
interrupção que acabamos de criar será mostrado com o nome da 


função. Veja: 








tos de Interrupção q 
Novor X Dd é eG Mostrar Colunas ~ Pesquisar: ~ Na Coluna: Todas visíveis X E 
Nome Rótulos Condição Contagem de Ocorrências 

e sempre interromper 











Figura 12.15: Ponto de interrupção de função listado na janela de pontos de exibição 


4. Tecle F5 para executar o programa. A execução vai parar a 
cada chamada ao método Escrever . 


Consulte a documentação oficial para conhecer as formas que 
podemos utilizar para restringir a especificação de função: 


https://docs.microsoft.com/pt- 


br/visualstudio/debugger/using-breakpoints?view=vs- 
20194BKMK Set a breakpoint in a source file 
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Ainda nesse exemplo, se desejássemos que o ponto de 
interrupção de função fosse ativado apenas para a segunda 
sobrecarga do método Escrever , precisaríamos especificar os 
tipos de parâmetro da função sobrecarregada. Neste caso: 
Escrever(string). 


12.6 ENVIANDO INFORMAÇÕES PARA A 
JANELA DE SAÍDA USANDO TRACEPOINTS 


Os tracepoints permitem ao desenvolvedor enviar informações 
para a janela de saída do Visual Studio em condições configuráveis 
sem modificar o código-fonte ou parar a execução. Isso é feito ao 
atribuir uma cadeia de caracteres de saída à caixa de seleção Ações 
na janela Configurações de ponto de interrupção. 


Vamos ilustrar como utilizar esse recurso com o programa de 
teste a seguir: 


using System; 


namespace ProdutividadeEmCSharp 
{ 
class Program 
{ 
public static int Fibonacci(int n) 
{ 
int a = 
int b = 
for (int i = 0; i < n; i++) 


{ 


9, 
1; 


int temp = a; 
a= b; 
b temp + b; 


} 


return a; 
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static void Main(string[] args) 


{ 
for (int i = 0; i < 15; i++) 
{ 
Console.writeLine(Fibonacci(i)); 
3 
Console.ReadLine(); 
3 


Para definir um tracepoint, é necessário criar inicialmente um 
ponto de interrupção simples. Após a sua criação, execute os 
seguintes passos: 


l. Pare o mouse sobre o círculo vermelho do ponto de 
interrupção e clique no ícone de engrenagem. A janela 
Configurações de ponto de interrupção será exibida. 


2. Marque a caixa de seleção Ações. Note que o círculo 
vermelho se transforma em um losango, o que indica que 
você mudou de um ponto de interrupção para o tracepoint. 


3. As opções relacionadas às ações serão exibidas. Insira a 
mensagem que você deseja exibir na caixa de texto Mostrar 
uma mensagem na Janela de Saída. Para este exemplo, digite: 

a: {a} b: {b} . Note que é possível, se você desejar, forçar 
a parada da execução ao atingir o tracepoint desmarcando a 
opção Continuar execução do código. 


4. Se necessário, adicione condições que determinam se a 
mensagem é exibida. Para isso, marque a caixa de seleção 
Condições e informe as condições. 


5. Clique no botão Fechar. 
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6 TE 


class Program 


















































7 7 
8 JE public static int Fibonacci(int n) 
a { 
10 int a = 0; 
11 int b = 1; 
12 JE for (int i = 0; i < n; i+) 
13 { 
14 int temp = a; . 
15 a = b; 
16 b = temp + b; 
$7 H 
Localização: Program.cs, linha: 17, caractere: 13, Deve coincidir com o código-fonte 
Condições 
“| Ações 
Mostrar uma mensagem na Janela de Saída: a: {a} b:(b) 
*| Continuar execução do código 
Fechar 
4 
18 return a; 
19 } 
20 


Figura 12.16: Configurando a saída que será gerada pelo tracepoint 


6. Tecle F5 para executar o programa em modo de depuração. 


A janela Saída da sua instância do Visual Studio 


provavelmente não estará visível neste momento. Para exibi-la, 


clique no menu Depurar, selecione o submenu Janelas e, a seguir, a 


opção Saída. Confira na imagem a seguir a saída produzida pelo 


tracepoint: 
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TRACEPOINTS 


Saída 7x 


Mostrar saída de: Depuração ” 


H 
(o 
N 
b 


ooo 
de des UT US DO hei fã JO fd od OD ed fa 
Soo o L CDC e o aa a > TO o 
PO da 00 UM UM O da UM US O PUNE 


4 + 


Figura 12.17: Inspecionando os valores impressos pelo tracepoint na janela de saída 


Ao digitar o texto a ser exibido na caixa de mensagem Mostrar 
uma mensagem na Janela de Saída note que o IntelliSense está 
ativo. Experimente digitar um sinal de $ e observe que existem 
variáveis internas do Visual Studio que podem ser inseridas nas 
mensagens, como S$FUNCTION representando a função atual ou 

$CALLER representando a função chamadora da função atual. 
Veja na imagem a seguir a lista de variáveis mostrada pelo 
IntelliSense: 
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Localização: Program.cs, linha: 8, caractere: 9, Deve coincidir com o código-fonte 





Condições 














“| Ações 





Mostrar uma mensagem na Janela de Saída: $| 

















<| Continuar exe Endereço da instrução atual SADDRESS an 
SCALLER 
SCALLSTACK 
SFILEPOS 
ET SFUNCTION 
return 1; Jein 
long valor = 1; SPNAME 
= for (int i = n; i > 0; i--) STICK 
t STID v 


valor *= i; 


} 


Figura 12.18: Usando variáveis internas nas mensagens 


Perceba que este é um daqueles recursos que pode nos poupar 
um tempo considerável de depuração quando bem explorado, 
pois nos permite gerar um log da execução sem alterar o 
código-fonte. Para saber mais sobre tracepoints, consulte a 
seguinte página da documentação oficial: 


https://docs.microsoft.com/pt- 
br/visualstudio/debugger/using-tracepoints?view=vs-2019 





12.7 NAVEGANDO PELO CÓDIGO EM MODO 
DE INTERRUPÇÃO 


Quando estamos no modo de interrupção, podemos depurar 
de forma interativa, enquanto observamos como a execução do 
código progride. Temos à disposição as seguintes opções da 
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navegação de código: 


e Continue (F5) - Esta opção abandonará o modo de 
interrupção e continuará a execução do programa até o 
próximo ponto de interrupção ser atingido, se ele existir. 
Nesse caso, o Visual Studio entrará novamente no modo de 
interrupção. 


e Pular método/Step Over (F10) - Executará a linha atual e 
será interrompida na próxima linha de código. 


e Intervir/Step Into (F11) - É usada quando a próxima linha 
de execução é um método ou uma propriedade. Quando 
clicado, o depurador entrará na primeira linha do código 
do método. 


e Executar para este lugar - Este recurso, introduzido no 
Visual Studio 2017, permite continuar a execução e 
interromper em um local especificado sem um ponto de 
interrupção. Para isso, basta clicar na seta verde que 
aparece no início de cada linha quando o mouse está 
parado sobre ela. Outra forma de chegar ao mesmo 
resultado é parar com o cursor de inserção na linha 
desejada e teclar Ctrl + F10 ou clicar com o botão direito do 
mouse na linha em questão e selecionar no menu de 
contexto a opção Executar até o Cursor. Veja: 
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= class Program 














8 [ 
9 
10 E static void Main(string[] args) 
11 { 
12 int total = 0; 
13 = for (int i = 0; i < 100; i++) 
4 í 

o as sos: um 
16 Console.WriteLine(total); 
17 Pi EE 
18 + 
19 | Executar para este lugar 
20 
21 } 


Figura 12.19: Usando a opção de navegação Executar para este lugar 


e Definir próxima declaração (Ctrl + Shift + F10)_ - Esta 
opção do menu de contexto permite pular a execução de 
uma parte do código, definindo de forma arbitrária a 
próxima linha de código a ser executada. Na prática, isso 
significa que a linha atual marcada pela seta amarela não 
será executada. Como alternativa, é possível arrastar a seta 
amarela com o mouse para qualquer linha do nosso 
código-fonte. 


A capacidade de alterar o fluxo de execução simplesmente 
arrastando a seta amarela nos permite testar caminhos de execução 
de código diferentes ou executar novamente o código sem reiniciar 
o depurador. Isso é algo poderoso e flexível, mas que precisa ser 
usado com certo cuidado, pois não é possível reverter o aplicativo 
para um estado anterior após mover o ponteiro de execução. 


f4 


A opção Executar até o cursor, mencionada anteriormente, é 
mais flexível do que aparenta em um primeiro momento. Você 
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pode iniciar automaticamente a depuração do código-fonte 
simplesmente clicando com o botão direito do mouse sobre uma 
linha qualquer do código-fonte e selecionando esta opção no menu 
de contexto. Isso fará com que a execução avance até o ponto onde 
o cursor está localizado, caso não exista nenhum ponto de 
interrupção definido no caminho. Se existir, tecle F5 para avançar 
e veja que a execução para no ponto onde o comando foi 
sinalizado. 


Reiniciando o aplicativo rapidamente 


Durante a depuração de um código, por vezes nos distraímos 
com algum evento externo, como uma ligação, uma mensagem de 
WhatsApp ou um colega de trabalho nos chamando e por vezes 
precisamos recomeçar. Essas breves interrupções são suficientes 
para arruinar minutos de depuração na maioria dos casos. 


Para esses cenários, saiba que o Visual Studio oferece um 
recurso chamado Reiniciar que nos permite economizar um pouco 
de tempo. Para executá-lo, basta clicar no menu Depurar e 
selecionar a opção Reiniciar ou teclar Ctrl + Shift + F5. Isto fará 
com que o programa seja interrompido e reiniciado. O depurador 
será pausado no primeiro ponto de interrupção encontrado pela 
execução do código. 


Utilizando o recurso Editar e Continuar 


O recurso Editar e Continuar é uma daquelas funcionalidades 
oferecidas pelo Visual Studio para a linguagem C# que já existe há 
algum tempo, mas que é pouco explorada pelos desenvolvedores. 


A primeira coisa que devemos saber sobre o recurso é que ele 
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só funciona em builds de depuração e que está ativo por padrão. 


Essa funcionalidade permite que você faça alterações no código 
enquanto estiver no modo de interrupção. Em outras palavras, 
você não precisa parar de depurar e executar o programa 
novamente ao encontrar o bug. Basta alterar o código no modo de 
interrupção e o Visual Studio seguirá com a execução. 


Na imagem a seguir, temos um exemplo muito simples, mas 
que é suficiente para ilustrar a funcionalidade. Nesta simulação, 
estamos depurando um programa e percebemos que na linha 
seguinte a que paramos, precisaremos modificar a saída produzida 
pelo método writeLine da classe Console . Veja: 


ET 


[es] ProdutividadeEmCSharp E 
“using System; 
using System.Threading; 


A 





WN- 


4 = namespace ProdutividadeEmCSharp 
5 i 
6 
7 = class Program 
8 { 
9 
10 = static void Main(string[] args) 
11 {i 
1 int total = 0; 
13 TE for (int i = 0; i < 100; i++) 
14 { 
oa totar EH] 
16 Console.WriteLine(total); 
7 f Thread.Sleep(1080); 
18 
19 } 
20 } 
21 } 


Figura 12.20: Ilustrando um local onde podemos utilizar Editar e Continuar 


Para resolver o problema, nós simplesmente editamos o 
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argumento passado para o método WriteLine na linha 17 e 
seguimos com a depuração: 





19 E static void Main(string[] args) 
11 { 
12 int total = 0; 
13 je for (int i = 0; i < 100; i+) 
14 { 
o 15 total += i; 
16 Console.WriteLine($"Total: {tota1}");l| 
17 Thread.Sleep(1000); 
18 } 
19 } 
20 } 
21 } 


Figura 12.21: Empregando o recurso Editar e Continuar 


Simples assim! Obviamente, nem todas as alterações são 
suportadas. Não é possível, por exemplo, fazer alterações dentro de 
uma função lambda. 


Para conhecer a lista de alterações em C# que suportam esse 
recurso, consulte: 


https://docs.microsoft.com/pt- 
br/visualstudio/debugger/supported-code-changes-csharp? 
view=vs-2019 


https://github.com/dotnet/roslyn/wiki/EnC-Supported-Edits 


Para mais detalhes sobre como usar o Editar e Continuar, 
acesse a seguinte página da documentação oficial: 


https://docs.microsoft.com/pt-br/visualstudio/debugger/how- 
to-use-edit-and-continue-csharp?view=vs-2019 
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12.8 VISUALIZANDO OS DADOS DURANTE A 
DEPURAÇÃO 


O Visual Studio nos oferece um poderoso conjunto de 
ferramentas para a visualização dos dados durante a depuração. 
Temos disponíveis as seguintes opções: 


e Janela Saída (Output) 

e Janela Imediata (Immediate) 

e Janela Locais (Locals) 

e Janela Automáticos (Autos) 

e Janelas de Inspeção (Watch) 

e Janela de Inspeção Rápida (QuickWatch) 

e Janelas de Inspeção Paralela (Parallel Watch) 

e Visualizadores de Depuração (Debugger Viewers) 
e Dicas de dados (Data Tips) 


Através de janelas, como Locais, Automáticos, Inspeção e 
Inspeção Rápida, podemos não só visualizar os valores de variáveis 
como também alterá-los durante a depuração do código. Para 
tanto, basta efetuar um duplo clique nos valores dessas variáveis e 
alterá-los. Também é possível alterar o valor de uma variável por 
meio das janelas Imediata e Dicas de dados. 


Utilizando a janela Saída 


A janela Saída (em inglês, Output) exibe mensagens geradas 
pelo Visual Studio durante a importação de pacotes, compilação, 
depuração, gerenciamento de código-fonte, publicação etc. É 
através dela que visualizamos mensagens de erro e de advertências 
emitidas pelo compilador, dentre outras. O que muitos não sabem 
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é que também é possível escrever nessa janela mensagens de debug 
criadas pelo próprio desenvolvedor para auxiliar no processo de 
depuração do código. 


Para exibir a janela, clique no menu Exibir e selecione a opção 
Saída ou pressione Ctrl+Alt+O. Para escrever na janela Saída, 
devemos usar os métodos das classes Debug e Trace presentes 
no namespace System.Diagnostics . O exemplo a seguir ilustra 
o uso do método writeLine da classe Debug : 


using System; 
using System. Diagnostics; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


£ 


static void Main(string[] args) 


{ 


Debug.wWriteLine("Houston, temos um problema!"); 
Console.ReadLine(); 


Confira o resultado na próxima imagem: 


Saída gi AT 


Mostrar saída de: Depuração s Eta 


“ProdutividadeEmCSharp.exe” (CoreCLR: DefaultDomain): Carregado "C:\Program Filesidotnetish a 
“ProdutividadeEmCSharp.exe” (CoreCLR: clrhost): Carregado "C;iUsersiClaudioisourceireposiPr 
"ProdutividadeEmCSharp.exe" (CoreCLR: clrhost): Carregado "C:\Program FilesidotnetisharediM 
“ProdutividadeEmCSharp.exe” (CoreCLR: clrhost): Carregado "C:\Program FilesidotnetisharediM 
*ProdutividadeEmCsharp-exe” (CoreCLN: clrhost): Carregado "C:\Program FilesidotnetisharedM 







“ProdutividadeEmCSharp.exe” (CoreCLR: clrhost): Carregado "C:\Program FilesidotnetisharedM 
“ProdutividadeEmCSharp.exe” (CoreCLR: clrhost): Carregado "C:\Program FilesidotnetisharediM 
“ProdutividadeEmCSharp.exe"” (CoreCLR: clrhost): Carregado "C:\Program FilesidotnetisharediM 


Figura 12.22: Escrevendo mensagens na janela Saída do Visual Studio 
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Ao examinar as mensagens geradas na janela Saída, você vai 


notar que ela contém “lixo”, ou seja, várias mensagens que não nos 


interessam no momento. É possível filtrar a origem das mensagens 


que serão ou não exibidas nessa janela, clicando com o botão 


direito do mouse sobre a janela e selecionando as opções 


relacionadas à exibição no menu de contexto. Veja: 


Saída 


Mostrar saída de: Depuração 7 


Produti == = Porem a 
Copiar Ctrl+C 












0! 
= Limpar Tudo 
X Excluir Del 


Mensagens de Exceção 
Mensagens de Filtragem de Etapa 
Mensagens de Carga do Módulo 


Mensagens de Saída de Processo 


Mensagens de Saída da Thread 


i 
I 
] 
] 
] 
I 
i 
! 
E Mensagens de Descarga do Módulo 
] 
] 
f 
] 
] 
] 
i 
I 
i 


Saída do Programa 


Ix 


valor 10 e foi chamada por a 


> 


Figura 12.23: Especificando os filtros de mensagens ativos da janela Saída usando o menu de 


contexto 


Também é possível realizar essa seleção através da caixa de 


diálogo Opções do Visual Studio, acessível através do menu 


Ferramentas. Para exibir os filtros de mensagem, selecione 


Depuração e, a seguir, Janela de Saída no menu da esquerda. 


Confira na imagem a seguir: 
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Opções ? x 
Opções de Pesquisa (Ctrl+E) P |» Configurações de Rastreamento de WPF | 
F Geral A Animação Desligado 
ASP.NET Core Associação de Dados Aviso 
Compilar e executar Congelável Desligado 
Configurações do Projeto VC++ Dicionários de Recurso Desligado 
Desempenho Documentos Desligado 
b Gerenciamento de Pacotes Web Escopo de Nome Desligado 
Locais Eventos Roteados Desligado 
Padrões de VB Hospedagem de HWND Desligado 
Projetos no estilo de SDK Marcação Desligado 
Projetos Web Propriedades de Dependência Desligado 
b Controle do Código-Fonte v Configurações Gerais de Saída o 
b Itens de Trabalho F Mensagens de Carga do Módulo Desligado i 
b Editor de Texto | Mensagens de Descarregamento do Módu Desligado 1 
4 Depuração Í Mensagens de diagnóstico Natvis (soment Desligado i 
eta . | Mensagens de Exceção Desligado | 
ea i Mensagens de Filtragem da Etapa Desligado ! 
Simbolos l Mensagens de Pesquisa de Símbolos do M Ligado i 
> EE e iT i Mensagens de Sr do Processo Desligado ! 
> Autenticação do Serviço do Azure 1 Mensagens de Saída do Thread Desligado H 
b Aase buakaka 1 Todas as saídas da depuração Ligado + 
eoe R Oen j 
b Designer de Formulários do Windows 
p Designer XAML EE 
b Fé Tools EE 
R R E Dados v Define o nível de rastreamento para Animação no WPF 
< 
Cancelar 








Figura 12.24: Especificando os filtros de mensagens ativos da janela Saída usando a caixa de 
diálogo Opções 


Caso deseje manter a saída produzida pelo seu código para 
compartilhar com outros desenvolvedores, saiba que o Visual 
Studio permite salvar durante a depuração o conteúdo da janela 
Saída com um mínimo de esforço. Basta clicar no menu Arquivo e 
selecionar a opção Salvar Saída como. Por padrão, o arquivo será 
nomeado como Saída-Depuração.txt . 


Saiba também que é possível, se você desejar, forçar a exibição 
da janela Saída toda vez que o build iniciar. Para tanto, execute os 
seguintes passos: 


1. Clique no menu Ferramentas e selecione Opções. 
2. A caixa de diálogos Opções será exibida. No painel da 
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esquerda, clique em Projetos e Soluções. 

3. Na lista de opções mostrada na parte direita da janela, 
selecione a caixa de verificação Mostrar janela de saída no 
início da compilação. 

4. Clique no botão OK. 

































































Opções ? x 
pç estilo Pesquisa (GiiRE) P a Sempre mostrar a Lista de Erros se houver erros ao finalizar a compilação 
4 Ambiente il Controlar item ativo no Gerenciador de Soluções 
Geral [Z] Avisar ao usuário quando o local do projeto não for confiável 
Atualizações de Produto a 
AutoRecuperação 
Configurações de Confiança = p 
Configurações Internacionais M] Solicitar antes de mover arquivos para um novo local 
Contas [M] Permitir a inicialização de projeto paralelo 
Documentos [4] Reabrir documentos ao carregar a solução 
Extensões [ Restaurar o estado da hierarquia do projeto do Gerenciador de Soluções no carregamento da sol 
Fontes e Cores M] Abrir arquivos de projeto no estilo do SDK com um clique duplo ou com a tecla Enter 





Guias e Janelas 
Importar e Exportar Configuraçõe 
Inicialização 
Lista de Tarefas 
Localizar e Substituir 
Navegador da Web 
Teclado 
Versão Prévia dos Recursos 
b Projetos e Soluções 
Controle do Código-Fonte 
Itens de Trabalho 
Editor de Texto 
Depuração 
Ferramentas de Desempenho 
Autenticação do Serviço do Azure 
Azure Data | ake 





lAvvvv ver 


> 











Figura 12.25: Ativando a exibição da janela Saída no início da Compilação 


Utilizando a janela Imediata 


A janela Imediata é usada para depurar e avaliar expressões, 
executar instruções e imprimir valores de variáveis. Ela funciona 
como uma janela de linha de comando no Windows ou Linux que 
permite repetir as últimas entradas digitadas através das setas do 
cursor e limpar a janela usando a opção Limpar tudo presente no 
menu de contexto. 
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Para ilustrar o seu uso, vamos utilizar o programa a seguir: 


using Sy 
using Sy 
using Sy 


namespac 


{ 


clas 


{ 


clas 


{ 


stem; 
stem.Collections.Generic; 
stem. Ling; 


e ProdutividadeEmCSharp 


s Pessoa 


public string Nome { get; set; } 


public int Idade ( get; set; } 


public char Genero ( get; set; } 


s Program 


static void Main(string[] args) 


i List<Pessoa> pessoas = new List<Pessoa>() 
{ 
new Pessoa(){Nome = "Pedro", Idade = 16, Genero = 
new Pessoa(){Nome = "Paulo", Idade = 18, Genero = 
new Pessoa(){Nome = "Marcela", Idade = 16, Genero 
new Pessoa(){Nome = "Roberta", Idade = 21, Genero 
new Pessoa(){Nome = "Ricardo", Idade = 19, Genero 
new Pessoa()(Nome = "Sofia", Idade = 14, Genero = 
new Pessoa()(Nome = "Vanessa", Idade = 22, Genero 
new Pessoa()(Nome = "Rodrigo", Idade = 20, Genero 
new Pessoa()(Nome = "Rebeca", Idade = 25, Genero 
new Pessoa()(Nome = "Henrique", Idade = 13, Gener 
new Pessoa()(Nome = "Pâmela", Idade = 21, Genero 
new Pessoa()(Nome = "Alessandra", Idade = 19, Gen 
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ero = 'F' 3 
+; 


Console.ReadLine(); 


Ao examinar esse código, note que incluímos uma referência a 
System.Ling . Apesar de não ser usado diretamente pelo 
programa, ele será necessário para efetuarmos consultas LINQ na 


lista pessoas. 


Para exibir a janela Imediata, clique no menu Depurar, 
selecione o submenu Janelas e, a seguir, a opção Imediata ou 
pressione Ctrl+Alt+I. 


Experimente digitar pessoas na janela Imediata durante a 
depuração seguido de Enter. Note que ela oferece suporte ao 
IntelliSense. Será exibido o total de itens na coleção juntamente 
com os elementos que a compõem. Veja: 
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Dé) Atquivo Editar Exibir Projeto Compilação Depurar Teste Análise Ferramentas Extensões Janela P) BH - o x 
Ajuda 
e- bM]? - > Continuar- dE, UNO SIT SS e lveshe É 
Program.cs + X -f 
[EB ProdutividadeEmCSharp =|, ProdutividadeEmCSharp.Program ~ | Pa Main(stringl] args) 8 
15 1 =| É 
16 E ListePessoa> pess = new List<Pessoa>() + 9 
17 { “x 
18 new Pessoa() (Nome = "Pedro", Idade = 16, Genero = 'M'), g 
19 "Paulo", Idade = 18, Genero = 'M'), 5, 
20 "Marcela", Idade = 16, Genero = 'F'}, g 
21 “Roberta”, Idade = 21, Genero = 'F'}, E: 
22 = "Ricardo", Idade = 19, Genero = 'M'), 
23 = "Sofia", Idade = 14, Genero = 'F'} 
24 “Vanessa”, Idade = 22, Genero 
25 “Rodrigo”, Idade = 20, Genero 
26 “Rebeca”, Idade = 25, Genero = 
27 “Henrique”, Idade = 13, Genero = 
28 “Pâmela”, Idade = 21, Genero = 'F'), 
29 “alessandra”, Idade = 19, Genero = 'F' } 
30 
o no 
32 
33 } 
34 } 
35 X 
100% = © Nāo foi encontrado nenhum problema | Sw ln:31 Car13 SPC CRLF 








pes: 

Count = 12 
[0]: (ProdutividadeEmCSharp. Pessoa) 
[1]: (ProdutividadeEmCSharp.Pessoa) 
[2]: (ProdutividadeEmCSharp.Pessoa) 
[3]: (ProdutividadeEmCSharp. Pessoa) 
[4]: (ProdutividadeEmCSharp.Pessoa) 
[5]: fProdutividadeEmCSharp. Pessoa) 
[6]: (ProdutividadeEnCSharp. Pessoa) 
[7]: (ProdutividadeEmCSharp. Pessoa) 
[8]: (ProdutividadeEmCSharp. Pessoa) 
[9]: (ProdutividadeEmCSharp. Pessoa) 
[10]: (ProdutividadeEmCSharp.Pessoa) 
[11]: (ProdutividadeEmCsSharp.Pessoa) 





Figura 12.26: Inspecionando a lista pessoas na janela Imediata 


Caso deseje saber apenas o total de itens na lista pessoas , 
basta digitar: 


pessoas.Count 


Ao analisarmos a lista retornada na janela Imediata vista na 
imagem anterior, podemos perceber que ela não retorna 
informações úteis para fins de depuração. Podemos alterar isso 
facilmente utilizando o atributo de depuração DebuggerDisplay , 
que será explicado em detalhes mais adiante. Para tanto, execute os 
seguintes passos: 


1. Adicione a linha a seguir acima da declaração da classe 


Pessoa : 
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[DebuggerDisplay("Nome: (Nome) - Idade: (Idade) - Gênero: (Genero 
.ToString()}")] 


2. Inclua referência para o namespace System.Diagnostics 
no código do arquivo: 


using System.Diagnostics; 


Após efetuarmos as alterações e repetirmos o teste anterior, 
veremos a seguinte saída: 


Janela Imediata “0x 
pessoas a 
Count = 12 


[0]: Nome: "Pedro" - Idade: 16 - Gênero: "M" 
[1]: Nome: "Paulo" - Idade: 18 - Gênero: "M" 
[2]: Nome: "Marcela" - Idade: 16 - Gênero: "F" 
[3]: Nome: "Roberta" - Idade: 21 - Gênero: "F" 
[4]: Nome: "Ricardo" - Idade: 19 - Gênero: "M" 
[5]: Nome: "Sofia" - Idade: 14 - Gênero: "F" 










[6]: Nome: "Vanessa" - Idade: 22 - Gênero: "F" 
[7]: Nome: "Rodrigo" - Idade: 20 - Gênero: 
[8]: Nome: "Rebeca" - Idade: 25 - Gênero: 


[9]: Nome: “Henrique” - Idade: 13 - Gênero: "M" 
[10]: Nome: "Pâmela" - Idade: 21 - Gênero: "F" 
[11]: Nome: "Alessandra" - Idade: 19 - Gênero: "F" 


Figura 12.27: Utilizando o atributo DebuggerDisplay para alterar a visualização da lista 
pessoas 


A janela Imediata avalia expressões compilando e usando o 
projeto atualmente selecionado. Em outras palavras, você pode 
usar expressões lambdas para descobrir na lista acima todas as 
mulheres maiores de idade. Basta executar: 


pessoas.where(p => p.Idade>=18 && p.Genero == 'F').Select(p => p. 
Nome) 


Utilizando as janelas Autos e Locals 


As janelas Automáticos e Locais (em inglês, Autos e Locals) 
exibem valores de variáveis durante uma sessão de depuração de 
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código-fonte em C#. Essas janelas são realmente úteis quando 
desejamos monitorar o escopo de objetos ao longo da depuração. 


A janela Automáticos mostra as variáveis usadas em torno do 
ponto de interrupção atual. Em C& e Visual Basic, esta janela 
exibirá qualquer variável usada na linha atual ou anterior. Para 
exibi-la durante a depuração, clique no menu Depurar, selecione o 
submenu Janelas e, a seguir, a opção Autos. 


A janela Locais mostra as variáveis definidas no escopo local, 
que geralmente é o método ou a função atual. Para exibi-la durante 
a depuração, clique no menu Depurar, selecione o submenu 
Janelas e, a seguir, a opção locais. 


Para entender a diferença entre elas, vamos partir do código do 
exemplo a seguir: 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
int a, b, c, d, e, f, 9g; 
a= 1; 
b = 2; 
c=3; 
d = 4; 
ës 5r 
f= 6; 
g=7; 
} 
} 
} 


Inclua um ponto de interrupção na linha d = 4 e execute o 
programa. Fxiba as duas janelas e compare as variáveis listadas em 
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cada uma delas. Confira nas imagens a seguir: 


Arquivo Editar Exibir Projeto Compilação Depurar = De) Prod...harp — o pras 
Teste Análise Ferramentas Extensões Janela Ajuda 


G- - g W P| D ~ C ~| Debug ny CPU A =º000 | lveShare S 


[es] ProdutividadeEmCSharp - S ProdutividadeEmCSharp.Program - o, Main(string[] args) ~ 
1 
2 Elnamespace ProdutividadeEmCSharp 


3 { 
4 E class Program 
5 t 

6 B st 
7 { 
8 

9 


“az 





> dr 
105 ap Jopenuas29 


ms 
sagôn 


atic void Main(string[] args 


a 
V 
— 
=] 








100% ~ O0 47 REsp. Fr ln:11 Car13 SPC CRLF 
Automáticos Rx 
Pesquisar (Ctrl+E) P- Profundidade de Pesquisa: 3 ~ Y A 


Nome Valor Tipo 
eb 2 int 
c 0 int 





Figura 12.28: Inspecionando variáveis na janela Automáticos 
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9 Arquivo Editar Exibir Projeto Compilação Depurar < J Prod...harp m o x 
Teste Análise Ferramentas Extensões Janela Ajuda 























o- - W x ~ Debug ny CPU Š E Š S I& Live Share q 
Program.cs + X z a 
c#| ProdutividadeEmCSharp = ProdutividadeEmCSharp.Program ~ ®©; Main(string[] args) | a, 

A = É 

1 T|6 

2 E namespace ProdutividadeEmCSharp - 2 

3 { E g 

J Na c 

4 [=| class Program kS 

5 { ns 

6 E static void Main(string[] args) 

; í | 

8 int a, bc d e, fo Ei 

9 a=1; 

10 b=2; 

o o =] 

12 d = 4; 

13 e= 5; 

14 f= 6; 

15 g.= 7; 

16 } 

17 } 

18 } - 
100% ~ O0 47 de eb Fr ln:11 Car13 SPC CRLF 
Pesquisar (Ctrl+ E) P- Profundidade de Pesquisa: 3 ~ TA 

ome Valor Tipo 

ea 
eb 
c 
d 
e 
ef 
eg 








4º Adicionar ao Controle do Código-Fonte « t 


Figura 12.29: Inspecionando variáveis na janela Locais 


Um detalhe importante a ser considerado é o de que ambas as 
janelas podem ser usadas para examinar os valores de retorno de 
método. Isso é particularmente útil quando os valores não são 
armazenados em variáveis locais. Um método pode ser usado 
como um parâmetro ou como o valor retornado de outro método. 
Confira na imagem a seguir os valores retornados pelos métodos 


soma e subtracao : 
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9 Arquivo Editar Exibir Projeto Compilação Depurar = P Prod...harp m o x 
Teste Análise Ferramentas Extensões Janela Ajuda 


























o- -e bah - Q ~ | [Debug ny CPU $ => > @ LiveShae S 
Program.cs + X X F 
G 
(cx) ProdutividadeEmCSharp ~ y ProdutividadeEmCSharp.Program ~ ®a Main(string[] args) -A 
Orefarências + E 
17 [| static void Main(string[] args) a JRR? 
= m 
18 { q 
19 Int as Parts ds es ace: 
20 a = 10; ‘Ge 
21 b = 5; ns 
22 c = 20; a 
23 d = 16; 
© 2 e = soma(a,b) + subtracao(c,d); 
[eq 25 e.WriteLine($"e: (e) £ 12ms dec 
26 } 
27 } 
28 } 
100% ~ © Não foi encontrado nenhum problema Jr Ln:25 Caris SPC  CRLF 








Pesquisar (Ctrl+ E) P- Profundidade de Pesquisa; 3 ~ Y A 
Nome Valor Tipo 
RO ProdutividadeEmCSharp.Program.soma retornado 
& ProdutividadeEmCSharp.Program.subtracao retornado - int 
e args {string[0]} string[] 
e a 10 int 
e 5 int 
c 20 int 
ed 16 int 
e 19 int 


Locais Automáticos 





Figura 12.30: Inspecionando os valores retornados por métodos na janela Locais 


Matrizes e objetos são exibidos nas janelas de depuração como 
controles de árvore. Para navegar pela árvore, basta selecionar a 
seta à esquerda de um nome de variável para expandir a exibição e 
mostrar campos e propriedades. Exemplo: 
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Locais 


Pesquisar (Ctrl+ E) 


Nome 





vovo vv 


ARARAS 


4 @ pessoas 
(2! 


[0] 


# Genero 
# Idade 
# Nome 


mM 
[2] 
[3] 
[4] 
[5] 
[61 


Profundidade de Pesquisa: 3 


Valor 
Count = 12 


| fProdutividadeEmCSharp.Pessoa) 


TUM 

16 

"Pedro" 
(ProdutividadeEmCSharp.Pessoa) 
(ProdutividadeEmCSharp.Pessoa) 
(ProdutividadeEmCSharp.Pessoa) 
(ProdutividadeEmCSharp.Pessoa) 
(ProdutividadeEmCSharp.Pessoa) 
!ProdutividadeEmCSharp.Pessoa! 


YA 


Tipo 
System.Collections.Generic.List<... 





ProdutividadeEmCSharp.Pessoa 


char 

int 

string 
ProdutividadeEmCSharp.Pessoa 
ProdutividadeEmCSharp.Pessoa 
ProdutividadeEmCSharp.Pessoa 
ProdutividadeEmCSharp.Pessoa 
ProdutividadeEmCSharp.Pessoa 
ProdutividadeEmCSharo.Pessoa 


Figura 12.31: Inspecionando objetos na janela Locais 


Em projetos escritos em .NET Core 3.0 ou superior, é possível 
usar os PINs (alfinetes) para fixar membros das classes como 
favoritos e obter um resultado semelhante ao obtido com o 
atributo de depuração 
Locais, Automáticos e Inspeção. Veja: 


DebuggerDisplay em janelas, como 


Locais x 
Pesquisar (Ctrl+ E) p- TA 


Nome Valor Tipo a 
Count = 12 


Profundidade de Pesquisa: 3 ~ 





pessoas System.Collections.Generic.List<... 








| Nome = "Pedro ProdutividadeEmCSharp.Pessoa 

# Nome 4 "Pedro" Q ~ string 

# Genero TUM char 

# Idade int 
b @ [1] ProdutividadeEmCSharp.Pessoa 
b e [2] ProdutividadeEmCSharp.Pessoa 
b [3] Nome = “Roberta” ProdutividadeEmCSharp.Pessoa 
b e [4] Nome = "Ricardo" ProdutividadeEmCSharp.Pessoa 
b 2 [5] Nome = "Sofia" ProdutividadeEmCSharp.Pessoa 
b e [6l Nome = "Vanessa" ProdutividadeEmCSharo.Pessoa Y 


Figura 12.32: Fixando membros como favoritos na janela Locais 


O formato numérico padrão nas janelas do depurador é o 
decimal. Para alterá-lo para hexadecimal, clique com o botão 
direito na janela e selecione no menu de contexto a opção Exibição 
Hexadecimal. 
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Para editar os valores das variáveis nas janelas Automáticos e 
Locais, efetue um clique duplo no valor atual e digite o novo valor. 


Um valor exibido em vermelho nessas janelas indica que o 
valor foi alterado desde a última avaliação. A alteração pode ter 
sido realizada pelo próprio desenvolvedor ou ocorrido em uma 
sessão de depuração anterior. 


Pesquisando nas janelas Automáticos, Locais e 
Inspeção 


As janelas de depuração Automáticos, Locais e Inspeção 
dispõem de uma barra de pesquisa que permite efetuar buscas por 


palavras-chave nas colunas Nome, Valor e Tipo. 









Sofia XxX - -> Profundidade de Pesquisa: 3 ~ Y A 
Nome Valor Tipo a 
4 @ pessoas Count = 12 System.Collections.Generic.List<Prod... 

> @ [0] Nome = "Pedro" ProdutividadeEmCSharp.Pessoa 

è 2 [1] Nome = "Paulo" ProdutividadeEmCSharp.Pessoa 

b [2] Nome = "Marcela" ProdutividadeEmCSharp.Pessoa 

b e [3] Nome = "Roberta" ProdutividadeEmCSharp.Pessoa 

b e [4] Nome = "Ri z ProdutividadeEmCSharp.Pessoa 

b e [6] Nome = "Vanessa" ProdutividadeEmCSharp.Pessoa 

t e [7] Nome = "Rodrigo" ProdutividadeEmCSharp.Pessoa 

b e [8] Nome = "Rebeca" ProdutividadeEmCSharp.Pessoa 

+ e [9] Nome = "Henrique" ProdutividadeEmCSharp.Pessoa 

+» e [10] Nome = “Pâmela” ProdutividadeEmCSharp.Pessoa v 


Figura 12.33: Pesquisando na janela Locais 


Note que é possível tornar a pesquisa mais ou menos completa, 
selecionando na lista suspensa Profundidade de Pesquisa quantos 
níveis de profundidade você deseja pesquisar em objetos 
aninhados. 
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Utilizando as janelas Inspeção e Inspeção Rápida 


Durante a depuração, utilizamos as janelas Inspeção e Inspeção 
Rápida (em inglês, Watch e QuickWatch) para explorar objetos, 
valores, propriedades e outros objetos aninhados como uma 
estrutura em árvore. As janelas de inspeção permitem exibir várias 
variáveis por vez durante a depuração, enquanto a caixa de diálogo 
Inspeção Rápida (QuickWatch) exibe uma única variável por vez e 
deve ser fechada antes que a depuração possa continuar. 


Para ilustrar o uso dessas janelas, vamos partir do exemplo a 
seguir que calcula o fatorial de um número usando uma função 
não recursiva: 


using System; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
public static long Fatorial(int n) 
{ 
if (n == 0) 
return 1; 
long valor = 1; 
for (int i = n; i > 0; i--) 
{ 
valor *= i; 
3 
return valor; 
3 
static void Main(string[] args) 
{ 
long resultado = Fatorial(10); 
Console.writeLine($"10!: {resultado}"); 
3 
3 
3 
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Adicione um ponto de interrupção na seguinte linha: 
long resultado = Fatorial(10); 


Tecle F5 para iniciar a depuração e, ao atingir o ponto de 
interrupção, tecle F11 para entrar no método Fatorial . Para 
inspecionar os valores das variáveis e parâmetros do método, basta 
clicar com o botão direito do mouse sobre eles e selecionar no 
menu de contexto a opção Adicionar Inspeção. Isso fará com que a 
variável ou parâmetro seja exibido na janela Inspeção 1. Veja: 
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9 Arquivo Editar Exibir Projeto Compilação Depurar E: Prod...harp Ee o x 
Teste Análise Ferramentas Extensões Janela Ajuda 














QG- - o W ai i ~ | Debug ny CPU e PS IÈ liveShare E 
Program.cs a X x F 
q 
(c&] ProdutividadeEmCSharp - A, ProdutividadeEmCSharp.Program - O Fatorial(int n) ~ A. 
1 using System; = a 
2 ala 
3 namespace ProdutividadeEmCSharp q 
4 { E 
SR a 
eferência E 
5 a class Program “ 
£ { 
74 E public static long Fatorial(int n) 
o 8 É <3ms decorridos 
9 if (n == 0) i 
10 return 1; 
a 
11 long valor = 1; 
12 El for (int i = n; i > 0; i--) 
13 { 
14 valor *= i; 
15 } 
16 return valor; 
17 } 
18 
19 E static void Main(string[] args) 
20 { 
o 2 long resultado = Fatorial(10); 
22 Console.wWriteLine($"10!: (resultado)"); 
23 } 
24 } 
25 > v 











nar item para assistir 





® Adicionar ao Controle do Código-Fonte « “o 


Figura 12.34: Inspecionando o valor de um parâmetro na janela de inspeção 


Note que essa janela está numerada porque é possível abrir até 
quatro janelas de inspeção simultaneamente e observar mais de 
uma variável em cada uma delas. A maioria dos desenvolvedores se 
contenta em usar uma única janela de inspeção, mas se desejar 
abrir janelas extras por alguma necessidade especial ou apenas para 
testar o recurso, basta clicar no menu Depurar, selecionar o 
submenu Janelas, a seguir o submenu Inspecionar e, por fim, 
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selecionar a opção de janela de inspeção desejada. 


Ao examinar a janela de inspeção na imagem anterior, repare 
que na primeira linha livre após a variável não existe uma 
mensagem Adicionar item para assistir. Podemos adicionar 
manualmente variáveis e expressões válidas nesta janela 
simplesmente clicando na linha livre e digitando o que desejamos 
inspecionar. Experimente adicionar a variável i durante a 
depuração do método Fatorial . Você verá que, à medida que 
você avança a depuração iterando pelo loop for do método 
Fatorial , os valores das variáveis vão sendo alterados na janela 
de inspeção. 


Uma forma rápida e pouco conhecida de adicionar uma 
variável ou membro de classe à janela de inspeção é efetuar um 
duplo clique sobre ele para selecioná-lo no editor de código e 
arrastá-lo até a janela. 


O recurso de arrastar, suportado pela janela de inspeção, é 
muito flexível e pouco explorado pelos desenvolvedores. Ele nos 
permite, por exemplo, expandir a coleção pessoas do tipo 
Pessoa dentro da janela Inspeção e arrastar um dos seus itens da 
coleção ( Pessoa[0] ) para baixo a fim de facilitar a sua 
visualização ou arrastá-lo para uma segunda janela de Inspeção, 
colocada lado a lado. 


Em alguns cenários, você pode desejar comparar as 
propriedades de um objeto populado do tipo Pessoa com uma 
instância recém-criada do mesmo tipo. Para isso, basta digitar new 
Pessoa() em uma linha da janela de inspeção. Veja: 
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Inspeção 1 “Ax 








Pesquisar (Ctrl+E) P- Profundidade de Pesquisa: 3 ~ TA 

Nome Valor Tipo 

4 # pessoas[0] Nome = "Pedro" ProdutividadeEmCSharp.Pessoa 
# Nome A "Pedro" Q ~ string 
# Genero TUM char 
# Idade 16 int 

7 
# Nome 9 null string 
# Genero 0o char 
# Idade 0 int 


Adicionar item para assistir 


Figura 12.35: Criando uma nova instância da classe na janela de inspeção 


Não é possível, entretanto, usar uma instrução como a 
mostrada a seguir para criar uma nova variável diretamente na 
janela de inspeção: 


Pessoa pessoal = new Pessoa(); 


Para executar essa linha com sucesso, será necessário entrá-la 
através da janela Imediata. Uma vez feito isso, será possível 
inspecionar a variável pessoal usando a janela de inspeção. 


Outra possibilidade a ser explorada pelo desenvolvedor ou 
desenvolvedora é a capacidade de chamar métodos de um objeto 
diretamente da janela de inspeção. Supondo que tenhamos um 
objeto calc do tipo Calculadora que possui um método 
Somar usado para somar dois valores inteiros, poderíamos digitar 
na janela de inspeção calc.Somar(5,6) eo retorno do método 
seria mostrado na coluna Valor. 


Mesmo que a janela de inspeção esteja se tornando mais 
poderosa e flexível a cada release do Visual Studio, em alguns casos 
você poderá preferir utilizar a janela Inspeção Rápida que nos 
permite observar uma única variável ou expressão. Para exibi-la, 
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clique com o botão direito do mouse sobre a variável ou expressão 
durante a depuração e selecione no menu de contexto a opção 
QuickWatch. A caixa de diálogo QuickWatch será exibida: 


DO] Arquivo 


QO- 














416 


2 
3 
4 


Editar 


ba 9- 


Exibir Projeto 


©] ProdutividadeEmCSharp 


using System; 


=jnamespace ProdutividadeEmCSharp 


z] static void Main(stri 
í 

long resultado = fl 

onsole.WriteLine( 


} 


class Program 


} 


Compilação 


Depurar Teste Análise Ferramentas 


Extensões Janela Ajuda 





b Continuar ~ 5! [E]. 





mó 








public static long Fatorial(int n) 


if (n == 0) 
return 1; 
long Valor = 1; 
for (int i = n; i 
valor *= i; 
return valor; 


} 


} 


Pesquisar (Ctr 


>sat|R. 


- ^ ProdutividadeEmCSharp.Program 











QuickWatch 


Expressão: 





valor 








Valor: 


o x 


Reavaliar 


Adicionar Inspeção 





[| Nome Valor 









Tipo 








Fechar N 





Ajuda 











Figura 12.36: Inspecionando o valor de uma variável na janela Inspeção Rápida 


Nessa janela, você pode digitar uma expressão, como valor + 
n e clicar no botão Reavaliar ou enviar a variável ou expressão 
atual para a janela de Inspeção clicando no botão Adicionar 
Inspeção. Para avançar com a depuração é necessário clicar no 
botão Fechar para fechar a caixa de diálogo. 
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Para saber mais sobre as janelas Inspeção e Inspeção Rápida, 
consulte a seguinte página da documentação oficial: 


https://docs.microsoft.com/pt- 


br/visualstudio/debugger/watch-and-quickwatch-windows? 
view=vs-2019 





12.9 EXPLORANDO DATATIPS 


Ao parar com o mouse sobre variáveis e membros de classe 
durante a depuração, será mostrada uma dica de dados (em inglês, 
DataTip) contendo seu valor atual. Veja na imagem a seguir: 


10 E static void Main(string[] args) 

11 { 

12 int total = 0; 

13 = for (int i = 0; i < 100; i+) 

14 { 

15 total += i; 

16 Co @ total 3 -="Total: {total}"); 
O 17 Threa | 

18 } 

19 } 

20 } 

21 } 


Figura 12.37: Exibindo uma DataTip para uma variável 


Para ocultar uma DataTip e inspecionar o que está embaixo, 
basta manter pressionada a tecla Ctrl e ela se tornará 
temporariamente invisível. 


Para alterar o valor da variável usando uma DataTip, efetue um 
clique no valor atual para editá-lo e digite o novo valor seguido de 
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Enter. Esse é o modo mais rápido de se atribuir um novo valor a 
uma variável. 


Ao clicarmos com o botão direito do mouse sobre a expressão 
em uma DataTip, veremos várias opções interessantes no menu de 
contexto: 


e Copiar - Copia para a área de transferência tanto a 
Expressão quanto o Valor (total = 5). 

e Copiar Expressão - Copia para a área de transferência só a 
Expressão (total). 

e Copiar Valor - Copia para a área de transferência só o valor 
(5). 

e Adicionar Inspeção - Adiciona expressão à janela Inspeção. 

e Adicionar Inspeção Paralela - Adiciona expressão à janela 
Inspeção Paralela. 


Caso deseje permanecer com o valor da variável visível 
enquanto avança com a depuração, basta fixar a dica de dados no 
editor. Para isso, clique no ícone de alfinete. Uma vez fixada a dica 
com o alfinete, é possível clicar com o mouse na DataTip e arrastá- 
la para o local mais adequado dentro do editor de código. Também 
é possível fornecer um comentário para uma DataTip. Veja: 









10 z static void Main(string[] args) 

+ u { @ total 5 x 
12 int total = 0; a y 
13 = for (int i = 0; i < 100; i++) Exemplo de comentário 4 
14 * { N 
15 total += i; 
16 Console.WriteLi $"Total: {total}"); 
7 ep | 


Figura 12.38: Exemplo de DataTip fixada e com um comentário 
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O suporte à fixação de DataTips é particularmente útil quando 
passamos pelo mesmo ponto de interrupção várias vezes, como em 
um loop. 


Exportando e importando DataTips 


Assim como ocorre com os pontos de interrupção, temos a 
opção de exportar as DataTips para um arquivo XML que pode ser 
compartilhado com outros desenvolvedores. 


Para exportar as DataTips, execute os seguintes passos: 


1. No menu Depurar, selecione a opção Exportar Data Tips. 

2. A caixa de diálogo Exportar DataTips será exibida. Navegue 
até o local onde deseja salvar o arquivo XML, digite um 
nome para o arquivo e selecione Salvar. 


Para importar as DataTips previamente criadas, execute o 
roteiro a seguir: 


1. No menu Depurar, selecione a opção Importar DataTips. 

2. A caixa de diálogo Importar DataTips será exibida. Selecione 
o arquivo XML contendo as DataTips que você deseja abrir e 
clique em seguida no botão Abrir. 


Utilizando visualizadores de dados para inspecionar 
tipos de dados complexos 


A presença de um ícone de lupa ao lado de uma variável ou 
propriedade em uma DataTip ou em uma das janelas de depuração 
indica que um ou mais visualizadores estão disponíveis para esse 
elemento do código. Os visualizadores exibem informações de uma 
maneira mais significativa e navegável. 
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Para exibir o elemento usando o visualizador padrão para o 
tipo de dados, basta clicar no ícone da lupa. Caso existam vários 
visualizadores disponíveis, é possível selecionar o desejado 
clicando na seta ao lado do ícone de lupa e escolhendo uma das 
opções no menu mostrado. Veja: 


7 JE static void Main(string[] args) 

8 { 

9 var mensagem = "Amigo leitor,\n\n\tobrigado por ter adquirido este livro. 
© o fonsole.ve mensagem [A [=] "Amigo leitor ininitobrigado por ter adquirido este livro. Esp 

11 } X 

12 } 

13 } 


Figura 12.39: Acessando um visualizador 


Na imagem a seguir, podemos observar o visualizador de texto 
exibindo uma string que contém quebras de linha: 





Visualizador de Texto o x 











Expressão: mensagem 





Valor: 





migo leitor, 


obrigado por ter adquirido este livro. Esperamos que ele o ajude em sua jornada diária 
de trabalho. 


Bom estudo! 
Cláudio Ralha 














M] Encapsular Ajuda 





Figura 12.40: Inspecionando o valor da variável mensagem no visualizador de texto 
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No Visual Studio, temos visualizadores de cadeias de caracteres 
internos para texto sem formatação, XML, HTML e JSON. Estão 
disponíveis também visualizadores internos para alguns outros 
tipos, como objetos DataSet, DataTable e DataView. 


Criando visualizadores de dados 


Caso nenhum dos visualizadores de dados internos do Visual 
Studio atenda a sua necessidade, saiba que é possível escrever seu 
próprio visualizador usando C# ou Visual Basic ou baixar 
visualizadores extras do Visual Studio Marketplace. Para tanto, 
pesquise por tag:Debugger Visualizer. 


Para criar seus próprios visualizadores, basta seguir os passos 
descritos em detalhes nas seguintes páginas: 


https://docs.microsoft.com/pt- 
br/visualstudio/debugger/create-custom-visualizers-of-data? 
view=vs-2019 


https://docs.microsoft.com/pt- 


br/visualstudio/debugger/walkthrough-writing-a-visualizer- 


in-csharp?view=vs-2019 
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CaríruLo 13 


ATRIBUTOS DE 
DEPURAÇÃO 


Ao longo do capítulo anterior, abordamos um grande número 
de ferramentas que tornam mais simples a tarefa de depuração. As 
ferramentas mencionadas podem ser usadas sem restrições, uma 
vez que estão disponíveis em todas as edições do Visual Studio 
(incluindo a gratuita) e o seu uso não implica alterações no código- 
fonte dos projetos. 


Neste capítulo, mergulharemos um pouco mais nas técnicas de 
debug e focaremos em atributos de depuração, um tipo de notação 
que pode ser adicionada ao código para tornar a depuração do 
projeto mais rápida e precisa. A partir desse ponto, será necessário 
efetuar alterações nos códigos das classes, mas você verá que o 
resultado justifica o esforço e que a mudança não afetará o código 
final voltado para release. 


Nas próximas seções, você aprenderá a utilizar os atributos 
DebuggerStepThrough j DebuggerHidden e 
DebuggerNonUserCode para acelerar o debug do código-fonte 
pulando partes desnecessárias geradas de forma automática por 
designers ou já bem testadas. 
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Em seguida, veremos como empregar os atributos de exibição 
do depurador DebuggerDisplay ,  DebuggerBrowsable e 
DebuggerTypeProxy , que nos permitem controlar como os dados 
serão exibidos. Conforme você pode perceber, todos os atributos 
de depuração possuem o prefixo debugger . Por esse motivo, não 
é necessário mencionar o prefixo, a exemplo do que fazemos ao 
omitirmos o sufixo controller no nome das controllers em 
ASP.NET e ASP.NET Core. 


Tenha em mente que não existe um jeito certo e único de se 
depurar. Assim como cada músico profissional é capaz de tocar 
um instrumento musical de forma única, cada desenvolvedor é 
capaz de combinar o leque de ferramentas que apresentamos de 
maneira personalizada a fim de encontrar soluções para os 
problemas com os quais se depara. 


Depurar é um momento especial no desenvolvimento e merece 
ter seu próprio ritual. Como regra geral, eu costumo reservar 
sempre o início do dia para corrigir erros em códigos mais 
complexos, pois é o período em que estamos mais descansados e 
aquele no qual é possível fugir mais facilmente das distrações. Uma 
boa playlist de músicas relaxantes e uma xícara de café bem quente 
são ótimas companhias para estes momentos em que beiramos o 
Neo desviando das balas da Matrix. 


13.1 EMPREGANDO OS ATRIBUTOS DE 
DEPURAÇÃO STEPTHROUGH, HIDDEN E 
NONUSERCODE 


O Cf suporta atributos que nos ajudam a pular algumas partes 
do código-fonte durante a depuração: DebuggerStepThrough , 
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DebuggerHidden e DebuggerNonUserCode . Vejamos a função 
de cada um deles. 


Ao decorar o código com o atributo DebuggerStepThrough , 
faremos com que ele seja executado, mas não depurado, mesmo 
que tenha sido definido um ponto de interrupção dentro do bloco 
de código. Esse atributo pode ser aplicado em: classe, estrutura, 
construtor e método. 


O atributo DebuggerHidden também impede os 
desenvolvedores de depurar o código e pode ser usado com os 
seguintes membros: construtor, método e propriedade. 


Para ilustrar como utilizar o atributo DebuggerStepThrough , 
vamos partir de um exemplo simples: 


using System; 
using System.Diagnostics; 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
Metodo1(); 
3 


[DebuggerStepThrough] 
public static void Metodo1() 


i Console.writeLine("Aqui a execução não para."); 
Metodo2(); 
3 
private static void Metodo2() 
{ 
Console.writeLine("Aqui a execução não para."); 
3 
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Marque dois pontos de interrupção no código conforme 
mostrado na imagem a seguir. Para criar o ponto de interrupção, 
basta clicar com o mouse na calha à esquerda da listagem no ponto 
desejado, ou parar com o cursor de inserção na linha em questão e 
teclar F9. Para executar o programa em modo depuração, basta 
teclar F5. 





DE] Arquivo Editar Exibir Projeto Compilação Depurar Teste Análise Ferramentas Extensões Janela Ajuda P Podhp — O x 
O- B- HR 2- - Debug ~ Any CPU - DP ProdutividadeEmCSharp - f B. bE == nm E IB LiveShare 
2 -ẹ 
É "EB ProdutividadeEmCSharp +], ProdutividadeEmCSharp.Program “19, Metodo? E 
7 1 [Eusing System; + ê 
E 2 using System.Diagnostics; ajg 
ê 3 É 
+ a | Enamespace ProdutividadeEmCSharp E 

5 1 E 
erências E 
6 TE class Program JE 
7 { É 
8 TE static void Main(string[] args) a 
9 
10 Metodo (); 
ou 
12 
13 [DebuggerStepThrough] 
14 E public static void Metodol() 
15 
(J 16 Console.WriteLine("Aqui a execução não para."); 
17 Metodo2(); 
18 } 
19 
20 fE private static void Metodo2() 
21 { 
22 Console.WriteLine("Aqui a execução não para."); 
23 } 
24 } 
25 
26 } 
120% ~ © Não foi encontrado nenhum problema fv Ln:26 Car2 SPC CRLF 





Figura 13.1: Marcando pontos de interrupção no programa de teste 


Ao executar o programa em modo depuração, lembre-se de 
que o ponto de interrupção “não atingível” estará sempre no modo 
de depuração marcado com um ícone de “ponto de exclamação”. 
Veja: 
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13 [DebuggerStepThrough] 





14 - >| public static void Metodo1() 
15 { 
Q 16 onsole.WriteLine("Aqui a execução não para."); 
17 Metodo2(); 
18 } 


19 


Figura 13.2: Sinalização de um ponto de interrupção não atingível 


Repita o teste substituindo o código 
[DebuggerStepThrough] por [DebuggerHidden] . 


Neste ponto, você provavelmente deve estar curioso sobre as 
diferenças entre os dois atributos, já que à primeira vista parecem 
realizar a mesma função. A primeira diferença é que não podemos 
decorar uma classe ou uma estrutura com o atributo 

DebuggerHidden , só podemos usá-lo com os membros internos. 
A segunda diferença é a de que o código decorado com 

DebuggerStepThrough será mostrado na janela Pilha de 
chamadas como 'código externo. O mesmo não ocorre se 
utilizarmos o atributo DebuggerHidden . 


Já o atributo DebuggerNonUserCode foi criado para sinalizar 
códigos que não foram criados especificamente pelo usuário, por 
exemplo, por um Designer do Visual Studio de forma automática, e 
que não devem ser mostrados na janela do depurador para não 
complicar a experiência de depuração. 


Para exibir a janela Pilha de chamadas e efetuar testes em seus 
programas, clique no menu Depurar, selecione o submenu Janelas 
e, a seguir, a opção Pilha de Chamadas. 
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Para saber mais sobre os atributos DebuggerStepThrough , 

DebuggerHidden e  DebuggerNonUsercCode , consulte 
respectivamente as seguintes páginas da documentação 
oficial: 


https://docs.microsoft.com/pt- 
br/dotnet/api/system.diagnostics.debuggerstepthroughattribu 
te?view=net-5.0 


https://docs.microsoft.com/pt- 
br/dotnet/api/system.diagnostics.debuggerhiddenattribute? 
view=net-5.0 


https://docs.microsoft.com/pt- 


br/dotnet/api/system.diagnostics.debuggernonusercodeattrib 
ute?view=net-5.0 





13.2 CONTROLANDO A EXIBIÇÃO COM O 
ATRIBUTO DE DEPURAÇÃO DISPLAY 


O atributo DebuggerDisplay controla como um objeto, 
propriedade ou campo é exibido nas janelas de variáveis do 
depurador. Esse atributo pode ser aplicado a assemblies, delegados, 
propriedades, campos e tipos. 


Para ilustrar o seu uso, vamos partir do programa a seguir: 
using System; 


namespace ProdutividadeEmCSharp 


{ 
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class Livro 


{ 
public string Titulo { get; set; } 
public string Autor { get; set; } 
public int AnoLancamento { get; set; } 

3 

class Program 

{ 


static void Main(string[] args) 


{ 


var livro = new Livro { Titulo="Produtividade em C#", 
Autor="Cláudio Ralha", AnoLancamento=2019}; 

Console.WwriteLine($"Título: {livro.Titulo} Autor: { 
livro.Autor} Ano: {livro.AnoLancamento}"); 


} 


Para inspecionar o valor da variável livro , vamos executar os 
seguintes passos: 


1. Adicione um breakpoint na linha que contém a definição da 
variável livro , clicando à esquerda do número de linha 
(linha 15 na imagem a seguir). 


2. Tecle F5 para executar o programa com o depurador ativo. 
3. Utilize F10 para avançar linha a linha. 


4. Ao ultrapassar a linha com o breakpoint, clique com o botão 
direito do mouse sobre a variável livro e selecione no 
menu de contexto a opção Adicionar Inspeção. A janela 
Inspeção 1 será exibida. Veja que a coluna Valor referente à 
variável livro não traz nenhuma informação útil: 
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Arquivo Editar Exibir Projeto Compilação Depurar Teste Análise Ferramentas Pi = o x 


Extensões Janela Ajuda 


O ShP 2- > Continuar - F [6] EO DD Blvestre S 
-F 
E] ProdutividadeEmCSharp ~  *&, ProdutividadeEmCSharp.Program - ® Main(string[] args) A 
using System; + È 
2 a a 
3 cinamespace ProdutividadeEmCSharp A 
fá 
© 
è G 
s ta class Livro G 
{f 
7 public string Titulo { get; set; } : 
eferència: É 
8 public string Autor ( get; set; ) 
9 public int AnoLancamento ( get; set; ) 
10 } 
11 =] class Program 
12 
3 e static void Main(string[] args) 
14 
o us ar livro = 








new Livro { Titulo = "Produtividade em C&”, Autor = "Cláudio Ralha”, AnoLancament 
teLine($"Título ivro.Titulo) Autor: (livro.Autor) 7 a 


9 16 re ($"T AnoLancament: 
17 } 
18 } 
19 } 
100% ~ © Não foi encontrado nenhum problema kAd 4 > Ln:16 Car:13 SPC CRLF 
Inspeção 1 “4x 
Pesquisar (Ctrl+ E P~- Profundidade de Pesquisa: 3 - TA 
Nome Valor Tipo 
+ © livro {ProdutividadeEmCSharp.Livro} p, ProdutividadeEmCSharp.Livro 
Adicionar item para assistir 





Figura 13.3: Ausência de informação útil na coluna Valor da ferramenta de Inspeção 


5. Interrompa a depuração clicando no botão com o quadrado 
vermelho na barra de botões. Adicione a linha a seguir acima 
da declaração da classe Livro : 


[DebuggerDisplay("Titulo: {Titulo} - Autor: {Autor}")] 


E inclua referência para o namespace System.Diagnostics 
no código do arquivo: 


using System.Diagnostics; 


Ao repetir o processo de depuração descrito no roteiro 
anterior, você verá que agora a coluna Valor apresenta informação 
útil para o desenvolvedor sobre o objeto. Confira na imagem a 


seguir: 
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Arquivo Editar Exibir Projeto Compilação Depurar Teste Análise Ferramentas 2 EEE = | x 
Extensões Janela Ajuda 





























o- Sus 9- > Continuar - F [8 m| DD lveshre É 
a 

z$ 

E 

[cs] ProdutividadeEmCSharp ~% ProdutividadeEmCSharp.Program - Pg Main(string[] args) -3 

1 |Gusing System; + È 

2 using System.Diagnostics; a| a 

3 A 

4 [Enamespace ProdutividadeEmCSharp É 

5 { a 

6 [DebuggerDisplay("Titulo: (Titulo) - Autor: (Autor)")] ad 

7 E class Livro 

8 i 

9 public string Titulo { get; set; } A 

10 public string Autor { get; set; } 

11 public int AnoLancamento { get; set; } 

12 } 

13 = class Program 

14 { 

15 fo static void Main(string[] args) 

16 1 
e 7 ar livro = new Livro ( Titulo = "Produtividade em C&”, Autor = “Cláudio Ralha”, AnoLancament 
(a 18 Console.WriteLine($"Título: {livro.Titulo} Autor: {livro.Autor} Ano: {livro.AnoLancamento 

19 } 

20 } = 
100% ~ © Não foi encontrado nenhum problema $v 4 > Ln:18 Car:1 SPC CRLF 
Inspeção 1 é ts 
Pesquisar (Ctrl+ E P~- Profundidade de Pesquisa: 3 - YA 

Nome Valor Tipo 
+» @ livro Titulo: “Produtividade em C#" - Autor: "Cláudio Es ProdutividadeEmCSharp.Livro 





Figura 13.4: Exibindo informações úteis na coluna Valor usando o atributo DebuggerDisplay 


O atributo DebuggerDisplay possui um único argumento, 
que é uma cadeia de caracteres a ser exibida na coluna de valor 
para instâncias do tipo. Essa cadeia de caracteres pode conter 
chaves ( { e } ) eo texto dentro de um par de chaves é avaliado 
como um campo, propriedade ou método da classe. No exemplo 
anterior, aplicamos o atributo em nível do tipo, mas também 
poderíamos tê-lo usado em uma propriedade ou campo específico. 


Vale destacar que se você sobrescrever o método ToString() 
da classe, o depurador vai usar o método substituído em vez do 
padrão que retorna apenas o nome do tipo (<typeName>) . Neste 
caso, você não precisará usar DebuggerDisplay . Caso ambos 
estejam presentes, o atributo DebuggerDisplay terá precedência 
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sobre o método ToString() substituído. 


Infelizmente, sobrescrever o método ToString() de uma 
classe nem sempre é uma opção viável. Existirão casos em que não 
desejaremos substituir o método ToString() apenas para fins de 
depuração e outros em que simplesmente não poderemos fazer a 
sobrescrita, pois a classe é definida em um assembly de terceiros. 
Para esses cenários, o uso do atributo DebuggerDisplay é uma 
excelente alternativa. 


Para saber mais sobre o atributo DebuggerDisplay , consulte 
as seguintes páginas da documentação oficial: 


https://docs.microsoft.com/pt- 
br/dotnet/api/system.diagnostics.debuggerdisplayattribute? 


view=net-5.0 





13.3 DEFININDO O QUE SERÁ EXIBIDO COM 
O ATRIBUTO DE DEPURAÇÃO BROWSABLE 


O atributo DebuggerBrowsable é utilizado para especificar 
como o campo ou a propriedade deve ser exibida na janela do 
depurador. O construtor desse atributo usa um dos valores de 
enumeração DebuggerBrowsableState , que especifica um dos 
seguintes estados: 


e Never : indica que o membro não é exibido na janela de 
dados, ou seja, o campo não é exibido quando você 
expande o tipo delimitador clicando no sinal de adição (+) 
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da instância de tipo. 


e Collapsed 
expandido por padrão. Este é o comportamento padrão. 


e  RootHidden 


estado indica que o próprio membro não é mostrado, mas 


: indica que o membro é exibido, mas não 


: sendo uma matriz ou uma coleção, esse 


seus objetos constituintes são exibidos. 


Vejamos a seguir um exemplo, inicialmente sem o uso do 


atributo DebuggerBrowsable : 


using System; 


using System. Diagnostics; 


namespace ProdutividadeEmCSharp 


string 
string 
string 
string 
string 
string 


string 
string 
string 


Logradouro ( get; set; } 
Bairro ( get; set; } 

CEP ( get; set; } 

Cidade ( get; set; 5 
Estado ( get; set; } 
Pais { get; set; 3 


Nome { get; set; 3 
Login { get; set; 3 
Password ( get; set, 3 


Endereco Endereco ( get; set; + 


{ 

class Endereco 

{ 
public 
public 
public 
public 
public 
public 

} 

class Usuario 

{ 
public 
public 
public 
public 

} 


class Program 


{ 


static void Main(string[] args) 


{ 


var usuario = new Usuario() { 


Nome = "Cláudio Ralha", 
Login = "claudioralha", 
Password = "naoconto", 
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Endereco = new Endereco() { 


Logradouro = "Rua dos Nerds, 
123", 
Bairro = "Alto da Boa Vista", 
CEP = "18700-000", 
Cidade = "Avaré", 
Estado = "São Paulo", 
Pais = "Brasil" 
) 
7 
Console.ReadKey(); 
} 
} 
} 


Ao inspecionarmos o objeto usuario na janela de inspeção 


do Visual Studio, veremos a seguinte saída: 





Pesquisar (Ctrl+ E) Pp- Profundidade de Pesquisa: 3 - TA 


me Valor Tipo 








usuario {ProdutividadeEmCSharp.Usuario} | ProdutividadeEmCSharp.Usuario 





J Endereco {ProdutividadeEmCSharp.Endereco} ProdutividadeEmCSharp.Endereco 
# Login "claudioralha" Q ~ string 
# Nome "Cláudio Ralha" Q ~ string 
# Password "naoconto" Q ~ string 


Adicionar item para assistir 


Figura 13.5: Inspecionando as propriedades do objeto usuario 


Note que a senha está sendo exibida e que o endereço do 
usuário aparece colapsado. Vamos agora alterar esse 
comportamento, modificando o código da classe Usuario 
conforme mostrado na listagem a seguir: 


class Usuario 


{ 
public string Nome { get; set; } 
public string Login { get; set; } 


[DebuggerBrowsable(DebuggerBrowsableState.Never)] 
public string Password { get; set; } 
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[DebuggerBrowsable(DebuggerBrowsableState.RootHidden)] 
public Endereco Endereco ( get; set; 3 


Ao inspecionarmos novamente o objeto usuario , veremos a 
seguinte saída na janela de inspeção: 








Inspeção 1 “7x 
Pesquisar (Ctrl+E) P- Profundidade de Pesquisa: 3 ~ Y A 
Nome Valor Tipo 
(O usuario | fProdutividadeEmCSharp.Usuario) | ProdutividadeEmCSharp.Usuario À 
* Bairro “Alto da Boa Vista" Q ~ string 
* CEP "18700-000" Q ~ string 
# Cidade "Avaré" Q ~ string 
# Estado "São Paulo” Q ~ string 
# Logradouro "Rua dos Nerds, 123" Q ~ string 
* Pais "Brasil" Q ~ string 
É Login “claudioralha" Q ~ string 
# Nome "Cláudio Ralha" Q ~ string 
Adicionar item para assistir 


Figura 13.6: Ocultando informações durante a depuração com o atributo DebuggerBrowsable 


Quando bem utilizada, esta capacidade de ocultar informações 
não relevantes dos objetos para fins de depuração em 
determinados momentos pode tornar o processo de depuração 
mais produtivo e menos cansativo. 


Para saber mais sobre o atributo DebuggerBrowsable 
consulte a seguinte página da documentação oficial: 


https://docs.microsoft.com/pt- 
br/dotnet/api/system.diagnostics.debuggerbrowsableattribute 


?view=net-5.0 
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134 MELHORANDO A VISUALIZAÇÃO DOS 
DADOS DURANTE A DEPURAÇÃO COM O 
ATRIBUTO DE DEPURAÇÃO TYPEPROXY 


Apesar de o atributo DebuggerBrowsable ser bastante útil na 
maioria dos casos, quando estivermos lidando com tipos que 
possuem um grande número de propriedades e campos, incluindo 
propriedades calculadas, ele não representará a melhor solução. 


Para lidar com esses cenários mais avançados de depuração, é 
possível utilizar o atributo DebuggerTypeProxy para indicar 
exatamente o que desejamos visualizar ao inspecionar o objeto. 
Para tanto, ele recebe em seu construtor uma classe especial criada 
pelo desenvolvedor contendo apenas o que é relevante. 


Para ilustrar como utilizar esse atributo, vamos alterar o 
programa da seção anterior conforme mostrado a seguir: 


using System; 
using System. Diagnostics; 


namespace ProdutividadeEmCSharp 
{ 
class Endereco 
{ 
public string Logradouro { get; set; } 
public string Bairro { get; set; } 
public string CEP { get; set; } 
public string Cidade { get; set; } 
public string Estado { get; set; } 
public string Pais { get; set; } 


class UsuarioTypeProxy 


£ 


private readonly Usuario usuario; 
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public UsuarioTypeProxy (Usuario usuario) 
{ 


this.usuario = usuario; 


} 


public string Nome => usuario.Nome; 
public string Login => usuario.Login; 


public string Endereco => $"{usuario.Endereco.Logradouro} 

- (usuario.Endereco.Bairro) - {usuario.Endereco.Cidade} - {usuar 

io.Endereco.Estado) - (usuario.Endereco.Pais) - CEP: (usuario.End 
ereco.CEP)"; 


3 


[DebuggerTypeProxy(typeof (UsuarioTypeProxy))] 
class Usuario 


{ 
public string Nome { get; set; } 
public string Login { get; set; } 
public string Password { get; set; } 
public Endereco Endereco { get; set; } 
} 
class Program 
{ 
static void Main(string[] args) 
{ 
var usuario = new Usuario() { 
Nome = "Cláudio Ralha", 
Login = "claudioralha", 
Password = "naoconto", 
Endereco = new Endereco() { 
Logradouro = "Rua dos Nerds, 
dear, 
Bairro = "Alto da Boa Vista", 
CEP = "18700-000", 
Cidade = "Avaré", 
Estado = "São Paulo", 
Pais = "Brasil" 
} 
7; 
Console.ReadKey(); 
} 
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Observe que a classe Usuario foi decorada com o atributo 

DebuggerTypeProxy , que recebeu como parâmetro a classe 

UsuarioTypeProxy , criada para filtrar o que desejamos visualizar 
durante a depuração do objeto: 


[DebuggerTypeProxy(typeof (UsuarioTypeProxy))] 


Ao inspecionar o objeto na janela de depuração do Visual 
Studio, você verá que agora apenas as propriedades desejadas são 
mostradas ao expandir usuario . Veja: 





Pesquisar (Ctrl+ E) P- Profundidade de Pesquisa 3 - Y A 


me Valor Tipo 








) usuario | {ProdutividadeEmCSharp. Usuario} | ProdutividadeEmCSharp.Usuario | 
# Endereco "Rua dos Nerds, 123 - Alto da Boa Vista - Avaré - São Paulo - Brasil - CEP: 18700-000" Q ~ string 
# Login “claudioralha” Q ~ string 
# Nome "Cláudio Ralha" Q ~ string 
b @ RawView 


Adicionar item para assistir 


Figura 13.7: Alterando a visualização das propriedades do objeto Usuario com o atributo 
DebuggerTypeProxy 


Note que ainda é possível consultar as demais propriedades, se 
desejável, expandindo Raw View: 


nspeção 1 “xX 
Pesquisar (Ctrl+ E) P- Profundidade de Pesquisa: 3 - Y A 
Nome Valor Tipo 
4 @ usuario fProdutividadeEmCSharp.Usuario) ProdutividadeEmCSharp.Usuario 
# Endereco “Rua dos Nerds, 123 - Alto da Boa Vista - Avaré - São Paulo - Brasil - CEP: 18700-000" Q + string 


# Login "claudioralha” Q = string 
"Cláudio Ralha" Q = string 







(ProdutividadeEmCSharp.Endereco) | ProdutividadeEmCSharp.Endereco 





"Alto da Boa Vista” Q = string 

"18700-000" Q ~ string 

"Avaré" Q ~ string 
Estado "São Paulo" Q ~ strin 

g 

# Logradouro "Rua dos Nerds, 123" Q ~ string 
# Pais "Brasil" Q = string 
Login "claudioralha” Q ~ strin 

Es g 
Nome "Cláudio Ralha” Q ~ strin 

g 

# Password "naoconto" Q = string 


Adicionar item para assistir 


Figura 13.8: Inspecionando as propriedades escondidas pelo atributo Debugger TypeProxy 


13.4 MELHORANDO A VISUALIZAÇÃO DOS DADOS DURANTE A DEPURAÇÃO 
COM O ATRIBUTO DE DEPURAÇÃO TYPEPROXY 437 


Obviamente, criar uma classe como  UsuarioTypeProxy 
apenas para fins de depuração só se justifica em cenários 
complexos para os quais esta abordagem ofereça um ganho real de 
tempo na depuração. 


Para saber mais sobre o atributo DebuggerTypeProxy , 
consulte a seguinte página da documentação oficial: 


https://docs.microsoft.com/pt- 


br/dotnet/api/system.diagnostics.debuggertypeproxyattribute 
*view=net-5.0 





Conforme você pôde observar ao longo deste capítulo, 
adicionar atributos de depuração em pontos estratégicos do código 
pode significar um ganho considerável de tempo no 
desenvolvimento de um projeto, especialmente no caso de sistemas 
complexos que envolvem vários desenvolvedores. Em termos 
práticos, esses atributos funcionam como um tipo de GPS 
apontando a rota mais rápida para solucionar um problema no 
código-fonte. 
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CarírtuLo 14 


COMPILAÇÃO 
CONDICIONAL 


A exemplo de outras linguagens, como o C++, em C& também 
temos suporte à compilação condicional, uma funcionalidade 
poderosa que utiliza símbolos de pré-processador e diretivas de 
pré-processamento, como define, “if, gelse, gelif e 
Hgendif para determinar quais partes do código serão compiladas 
e quais serão excluídas dos conjuntos finais. 


A compilação condicional é uma técnica que pode ser usada 
em um cenário de desenvolvimento entre plataformas para 
determinar as partes do código que são compiladas 
especificamente para uma determinada plataforma. Deste modo, é 
possível compilar condicionalmente qualquer seção de código em 
C& usando diretivas de pré-processamento. Essas diretivas são 
instruções especiais para o compilador executadas antes da 
compilação principal. 


Ao longo deste capítulo final, veremos como utilizar diretivas 
de pré-processamento com constantes definidas pelo usuário e 
como utilizar as diretivas de diagnóstico gerror e warning 
para impedir a compilação e sinalizar problemas. Abordaremos a 
seguir a constante DEBUG , que é incluída de forma automática em 
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modo de depuração, e constantes predefinidas para blocos de 
código direcionados para estruturas de destino específicas ((NET 
Framework, .NET Core e .NET Standard) e versões específicas de 
cada framework. Em seguida, veremos como utilizar o atributo 

Conditionalattribute como uma alternativa às diretivas 
condicionais em nossos projetos. O capítulo termina mostrando 
como utilizar as diretivas &region e gendregion para organizar 
melhor o seu código. 


14.1 UTILIZANDO DEFINIÇÕES DE SÍMBOLOS 
E  DIRETIVAS DE  PRÉ-PROCESSADOR 
CONDICIONAL 


Em C#, os símbolos do pré-processador podem ser definidos 
ou indefinidos no código durante a compilação. Quando o símbolo 
que você deseja definir tiver efeitos localizados (afetando apenas 
um arquivo), é comum criá-lo usando a diretiva de pré- 
processador Hdefine . A diretiva gdefine é seguida pelo nome 
do símbolo, como mostrado a seguir: 


tdefine EdicaoProfissional 


A declaração gdefine deve aparecer antes de todos os outros 
códigos em um arquivo, exceto para outras diretivas de pré- 
processamento. Veja: 


#define EdicaoProfissional 
using System; 


namespace ProdutividadeEmCSharp 


{ 


class Program 


{ 


#if EdicaoProfissional 
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const bool SuporteTelefonico = true; 
const bool SuporteViaEmail = true; 


#else 
const bool SuporteTelefonico = false; 
const bool SuporteViaEmail = false; 
#endif 
static void Main(string[] args) 
{ 
Console.wWriteLine($"Suporte Telefônico: {SuporteTelef 
onico)"); 
Console.wWriteLine($"Suporte via E-mail: (SuporteViaEm 
ailt”); 
3 
3 
3 


Note que nenhum valor é aplicado e que a constante definida é 
case sensitive. A declaração tdefine cria um símbolo que é 
válido para um único arquivo de código. Isso significa que, se você 
precisar usar o mesmo símbolo em vários arquivos, terá que defini- 
lo mais de uma vez. Tenha em mente que os símbolos não estão 
relacionados a classes ou outros tipos, portanto, mesmo que você 
utilize classes parciais, você deverá definir o símbolo em cada 
arquivo ou usar um símbolo com escopo de projeto para poder 
utilizá-lo. 


Para definir os símbolos do pré-processador com escopo de 
projeto, é necessário editar as propriedades do projeto no Visual 
Studio. Execute os seguintes passos: 


1. No Gerenciador de Soluções, clique com o botão direito do 
mouse sobre o nome do projeto. No menu de contexto, 
selecione a opção Propriedades. 


2. A página de propriedades do projeto será exibida. No menu 
da esquerda, clique na guia Build para ativar a página. 
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Adicione as constantes desejadas no campo Símbolos de 
compilação condicional, separando cada um com um espaço. 
Para este exemplo criaremos apenas o símbolo 
EdicaoProfissional. Veja: 


ET om 


Aplicativo 





EEE Configuração: | Ativo (Debug) v| Plataforma: | Ativo (Any CPU) ” 
Compilar" 
Eventos de Compilação Geral 
Pacote : 5 Í 
Símbolos de compilação condicional: |EdicaoProfissional 
Depurar À É = 











[Definir constante DEBUG] 
FZ Definir constante TRACE 





Assinatura 








Análise de Código 
Destino da plataforma: Any CPU ” 
Recursos 





Preferir 32 bits 








Permitir código não seguro 














Otimizar código 





Erros e avisos 


Nível de aviso: 4 {v 





Suprimir avisos: [1701;1702;1591 





Tratar avisos como erros 


O Nenhum 
O Todos 





@ Avisos específicos: |Nu1605 





Saída 





Caminho de saída: [ Procurar... 




















[7] Arquivo de documentação XML: [C:\Users\Claudio\source\repos\ProdutividadeEmCSharp\Proc] 





Gerar assembly de serialização: Auto ” 


Avançado... 


Figura 14.1: Definindo um símbolo de compilação condicional 


3. Observe que existe nessa tela uma opção Definir constante 
DEBUG que você também poderá usar para fins de 
depuração do código. Tecle Ctrl+s para salvar a alteração e a 
seguir feche a página de propriedades do projeto. 


Pronto! Isso é tudo que precisamos para ter um símbolo 
definido com escopo de projeto. Caso precise desligar um símbolo 
criado com escopo de projeto em um arquivo em particular, basta 
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utilizar a diretiva gundefine da mesma forma que usamos a 
diretiva #define . Exemplo: 


Hundefine EdicaoProfissional 


Uma vez definidas as constantes em nível de projeto ou de 
arquivo com a diretiva #define , já podemos especificar o que 
deve ser compilado ou ignorado com base no símbolo de pré- 
processador que acabamos de definir. Para tanto, utilizamos as 
diretivas #if , Helif, #else e gendif conforme ilustrado no 
exemplo anterior. Ao ser executado, o exemplo anterior produzirá 
a seguinte saída (assumindo que você definiu previamente o 
símbolo EdicaoProfissional ): 





EH CAWINDOWSisystem32icmd.exe — o >S 


Suporte Telefônico: True ^ 
Suporte via E-mail: True E 
Pressione qualquer tecla para continuar. . . m 


v 








Figura 14.2: Utilizando o símbolo EdicaoProfissional definido previamente 


De volta ao editor de código do Visual Studio, observe que o 
bloco que está desativado será mostrado em cinza, enquanto o 
bloco ativo terá seu código exibido nas cores normais: 


7 #if EdicaoProfissional 

8 const bool SuporteTelefonico = true; 
9 const bool SuporteViaEmail = true; 

10 telse 

11 = const bool SuporteTelefonico = false; 
12 const bool SuporteViaEmail = false; 
13 #endif 


Figura 14.3: Exibição do bloco ativo é feito de forma destacada 


Caso precise testar mais de um símbolo, é possível incluir uma 
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ou mais diretivas 4if conforme mostrado a seguir: 


#if EdicaoProfissional 
const bool SuporteTelefonico = true; 
const bool SuporteViaEmail = true; 
gelif EdicaoStandard 
const bool SuporteTelefonico = false; 
const bool SuporteViaEmail = true; 
#else 
const bool SuporteTelefonico = false; 
const bool SuporteViaEmail = false; 
#endif 


14.2 UTILIZANDO AS DIRETIVAS DE 
DIAGNÓSTICO #ERROR E #WARNING 


O Cf suporta duas diretivas de diagnóstico: terror e 
Hwarning . A error é usada para abortar a compilação, 
gerando um erro de compilação. Apesar de opcional, como boa 
prática devemos sempre fornecer uma mensagem de erro ao 
usarmos essa diretiva. Veja no programa a seguir um exemplo de 
uso: 


tdefine EdicaoProfissional 
//&define EdicaoEstudante 


using System; 


namespace ProdutividadeEmCSharp 
{ 
class Program 
{ 
#if EdicaoProfissional && EdicaoEstudante 
#error O programa não pode ser para profissional e estudante ao m 
esmo tempo! 
#endif 


#if EdicaoProfissional 
const bool SuporteTelefonico = true; 
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const bool SuporteViaEmail = true; 


telse 
const bool SuporteTelefonico = false; 
const bool SuporteViaEmail = false; 
#endif 
static void Main(string[] args) 
{ 
Console.wWriteLine($"Suporte Telefônico: {SuporteTelef 
onico)"); 
Console.wWriteLine($"Suporte via E-mail: (SuporteViaEm 
ail}"); 
3 
3 
3 


Ao examinar o código, note que existe uma linha comentada, 
na qual definimos a constante EdicaoEstudante . Rode a 
primeira vez da forma como está, em seguida descomente essa 
linha e tente novamente. Você verá que a linha que contém a 
diretiva terror é sinalizada antes mesmo da compilação, 
indicando que existe algo errado. Confira na imagem a seguir: 
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Arquivo Editar Exibir Projeto Compilação Depurar Teste Análise Pesquis... P Prod...harp = o x 
Ferramentas Extensões Janela Ajuda 
o- B-S moh - - Debug ~ AnyCPU - þ ProdutividadeEmCSharp ~ | | |O LiveShare É 
9 Program.cs » X X e 
a 
à [E] ProdutividadeEmCSharp - ^ ProdutividadeEmCSharp.Program - 2; Main(string[] args) -| à. 
A 
pa 1 ne EdicaoProfissional + 5 
3 2 e EdicaoEstudante 4 A 
A 3 g 
g 4 using System; q 
x 5 a 
6 cjnamespace ProdutividadeEmCSharp Nas 
7 { P 
P 3 
efe 8 
8 z class Program a 
a a 
: [ A 
10 #if EdicaoProfissional && EdicaoEstudante Q 
11 e r O programa não pode ser para profissional e estudante ao mesmo tempo! 
14 “if EdicaoProfissional 
15 const bool SuporteTelefonico = true; 
16 const bool SuporteViaEmail = true; 
17 se 
18 E false; 
19 
20 
21 xá 
100% ~ 01 ào e > Fr 4 > Ln:22 Car40 SPC CRLF 














Solução Inteira -~ |@ 1Ero | | & OAvisos | @ 0 Mensagens |Xy| Compilação + IntelliSens ~ Pesquisar na Lista de P ~ 


























Sa Taa e i AS E E E 


*error: "O programa não pode ser para 


2 
O o profissional e estudante do mesmo tempol” 


ProdutividadeEmCSharp Program.cs 11 Ativo 





M Adicionar ao Control 


Figura 14.4: Abortando a compilação com a diretiva terror 


O erro ocorre nesse caso porque especificamos com a diretiva 
Hif que não podemos ter as constantes EdicaoProfissional e 
EdicaoEstudante definidas ao mesmo tempo. 


O funcionamento da diretiva #warning é semelhante ao da 
gerror , com a diferença de que a primeira não interrompe a 
compilação. Essa diretiva gera apenas um aviso (em inglês, 
warning). 


14.3 UTILIZANDO A CONSTANTE DEBUG 


A constante DEBUG é inserida de forma automática quando 
compilamos o programa em modo Debug e suprimida quando 
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selecionamos o modo Release. 


x) Arquivo Editar Exibir Projeto Compilação Depurar Equipe Ferramentas Teste 


Q- H- JMP D- Debug E Any CPU - | ProdutividadeEmCSharp - 5! $ fE 


Debug 
ProdutividadeEmCSharp Release N 
c*| ProdutividadeEmCShark Gerenciador de Configurações... -i ProdutividadeEmCSharp.Program 














1 | using System; 


Análise Janela Ajuda 


Figura 14.5: Alternando entre os modos Debug e Release 


Experimente testar o programa da seção anterior alternando 


como mostrado a seguir os dois modos para ver a diferença: 


using System; 


namespace ProdutividadeEmCSharp 
{ 
class Program 
{ 
#if DEBUG 
const bool SuporteTelefonico = true; 
const bool SuporteViaEmail = true; 
#else 
const bool SuporteTelefonico = false; 
const bool SuporteViaEmail = false; 
#endif 


static void Main(string[] args) 
{ 
Console.WwWriteLine($"Suporte Telefônico 
onico)"); 
Console.wWriteLine($"Suporte via E-mail 
ail}"); 
3 


: (SuporteTelef 


: (SuporteViaEm 


Caso precise forçar a definição da constante DEBUG em modo 


Release por algum motivo específico, utilize a 


opção Definir 


constante DEBUG na página de propriedades do projeto: 
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x) Arquivo Editar Exibir Projeto Compilação Depurar Equipe Ferramentas Teste Análise Janela 





oO - H-S mW D- Debug ~ Any CPU ~ þ ProdutividadeEmCSharp ~ j7 
Aeee CTE S Program.cs 

Aplicativo - = i 
ED Configuração: Ativo (Debug) v Plataforma: Ativo (Any CPU) v 

Build 

Eventos de Build Geral 





Pacote 





Símbolos de compilação condicional: 


Depurar 
P [7 Definir constante DEBUG 


Assinatura e 
[7] Definir a constante TRACE 











Recursos 
Plataforma de destino: Any CPU 4 





Preferir 32 bits 








Permitir código não seguro 














Otimizar código 





Figura 14.6: Definindo de forma incondicional a constante DEBUG 


14.4 EMPREGANDO BLOCOS DE CÓDIGO 
PARA VERSÕES ESPECÍFICAS DO 
FRAMEWORK 


O sistema de compilação reconhece símbolos de pré- 
processador predefinidos que representam estruturas de destino 
diferentes em projetos, o que nos permite criar aplicativos que 
podem ser direcionados para mais de uma implementação ou 
versão do .NET. 


Confira as constantes definidas até o momento em que este 
livro foi escrito na tabela a seguir: 


Frameworks Símbolos 
de destino 
NET NETFRAMEWORK , NET20 , NET35 , NET40, NET45, NET451, 
E NET452 , NET46, NET461, NET462, NET47, NET471, 
Framework 

NET472, NET48 

NETSTANDARD , NETSTANDARD1 O, NETSTANDARD1 1, 
“NET NETSTANDARD1 2, NETSTANDARD1 3, NETSTANDARD1 4, 
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Standard NETSTANDARD1 5, NETSTANDARD1 6, NETSTANDARD2 O, 
NETSTANDARD2 1 


NETCOREAPP , NETCOREAPP1 O, NETCOREAPP1 1, 
.NET Core NETCOREAPP2 O, NETCOREAPP2 1, NETCOREAPP2 2, 
NETCOREAPP3 O, NETCOREAPP3 1 


O exemplo a seguir ilustra como usar as constantes 
NETFRAMEWORK , NETSTANDARD e NETCOREAPP : 


using System; 


namespace ProdutividadeEmCSharp 
{ 
class Program 
{ 
static void Main(string[] args) 
{ 
#if NETCOREAPP 
Console.WriteLine("Compilado para .NET Core!"); 
#elif NETFRAMEWORK 
Console.WwriteLine("Compilado para .NET Framework!"); 
#elif NETSTANDARD 
Console.wWriteLine("Compilado para .NET Standard!"); 
#endif 


Ao executar o programa após compilá-lo para .NET Core 3.1, 
veremos a seguinte saída: 





EM CAWINDOWS\system32\cmd.exe = E] x 


ompilado para .NET Core! Ê A 
Pressione qualquer tecla para continuar. . . m 





Figura 14.7: Detectando a estrutura de destino usando constantes de compilação 


Em termos práticos, a capacidade de identificar as estruturas de 
destino nos permite utilizar APIs mais recentes, quando 
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disponíveis. 


Para identificar qual estrutura de destino um projeto utiliza, 
execute os seguintes passos: 


1. Clique com o botão direito do mouse sobre o nome do 
projeto no Gerenciador de Soluções. No menu de contexto 
que será exibido, selecione Propriedades. 

2. A página de propriedades do projeto será exibida. Selecione a 
guia Aplicativo. 

3. Verifique a opção selecionada no campo Estrutura de 
Destino. Veja: 


DX] Arquivo Editar Exibir Projeto Compilação Depurar Teste Análise Ferramentas Extensões Janela Ajuda Pesquisar (Ctri+0) 























o- 3 - id Debug ~ Any CPU ~ P ProdutividadeEmCSharp - 7º [H] - 
sa 
f ERES Program.cs 
- E E 
T N/A N/A 
a Compilar 
z E = 
5 Eventos de Compilação Nome do assembly: Namespace padrão: 
É Pacote |ProdutividadeEmCSharp ProdutividadeEmCSharp 
Depurar Estrutura de Destino: Tipo de saída: 
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Um manifesto determina configurações específicas de um aplicativo. Para inserir um manifesto 
personalizado, adicione-o ao projeto e selecione-o na lista abaixo. 


Icone: 








(Ícone Padrão) v | | Procurar.. E) 
Manifesto: 

i sa x a ] 
Inserir manifesto com configurações padrão “| 











O Arquivo de recurso: 


Figura 14.8: Verificando a estrutura de destino na página de propriedades do projeto 


14.5 USANDO O ATRIBUTO CONDITIONAL 
EM UM MÉTODO 


Uma alternativa mais moderna e legível ao uso de diretivas de 
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pré-processamento gif é o atributo Conditionalattribute , 
que nos permite desligar a compilação e a chamada a certos 
métodos com base nos símbolos que definimos com a diretiva 
#define . Veja a seguir um exemplo bem simples: 


gdefine PRODUTIVIDADE 
using System; 
using System. Diagnostics; 


namespace ProdutividadeEmCSharp 
{ 
class Program 
{ 
[Conditional("PRODUTIVIDADE")] 
static void MetodoA() 
{ 
Console.writeLine("Obrigado por adquirir o livro Prod 
utividade em C#!"); 


} 


[Conditional("DEBUG")] 
static void MetodoB() 
{ 
Console.writeLine("Este livro é fruto de um longo est 
udo sobre a linguagem C# desde a sua origem."); 


3 
static void Main(string[] args) 
{ 
MetodoA(); 
MetodoB(); 
3 


Observe que o atributo Conditionalattribute recebe como 
parâmetro uma literal com o nome do símbolo cuja definição será 
verificada. Veja também que no início do código-fonte temos 
apenas a definição da constante PRODUTIVIDADE , já que a 
constante DEBUG é gerada de forma automática em modo Debug. 
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Ao ser executado em modo Debug, este programa gerará a 
seguinte saída: 





EM CAWINDOWSisystem32Acmd.exe — o b> 


Obrigado por aquirir o livro Produtividade em C&! ^ 
Este livro é fruto de um longo estudo sobre a linguagem C# desde a sua origem. 
Pressione qualquer tecla para continuar. . 











Figura 14.9: Executando o programa em modo Debug 


Alterando para modo Release, obteremos a saída mostrada na 
próxima imagem: 





E CAWINDOWS\system32\cmd.exe — o XxX 


Obrigado por aquirir o livro Produtividade em C#! ^ 
Pressione qualquer tecla para continuar. . 








Figura 14.10: Executando o programa em modo Release 


r 


Conforme você pode observar, o método MetodoB só é 
executado em modo Debug. 


Por meio do atributo Conditionalattribute , temos uma 
forma clara e de fácil manutenção para definir a existência de um 
método dependendo de uma diretiva de pré-processador. 
Infelizmente, só podemos definir um método como condicional se 
ele não retornar um valor, ou seja, se ele retornar void. 
Obviamente, podemos driblar esta limitação quando necessário 
usando parâmetros. 
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Para saber mais sobre o atributo Conditionalattribute , 
acesse a seguinte página da documentação oficial: 


https://docs.microsoft.com/pt- 


br/dotnet/api/system.diagnostics.conditionalattribute? 
redirectedfrom=MSDN%5C&view=net-5.0 





14.6 ATIVANDO O SUPORTE A TIPOS DE 
REFERÊNCIA ANULÁVEIS 


O C# 8.0 introduziu uma distinção entre tipos de referência 
nulos e não nulos para evitar erros frequentes dos programadores 
que resultam em exceções do tipo NullReferenceException . De 
forma semelhante aos tipos de valores anuláveis, um tipo de 
referência anulável é criado anexando um ponto de interrogação 
( ? ) ao tipo. Quando estamos trabalhando usando este novo 
recurso, é possível atribuir um valor nulo apenas ao tipo de 
referência anulável. Veja: 


string? titulo = null; // tipo de referência anulável 
string autor = "Cláudio Ralha", // tipo de referência não anuláve 


O suporte a tipos de referência anuláveis não está ativo por 
padrão, o que significa que se você tentar usar uma linha de código 
como a mostrada a seguir: 


string? titulo = null; 


Verá a seguinte mensagem de alerta: 
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A anotação para tipos de referência anuláveis deve 
ser usada apenas em código dentro de um contexto de 


anotações '#nullable' 


Para habilitar essa funcionalidade para o projeto inteiro, 
execute os seguintes passos: 


1. Clique com o botão direito do mouse sobre o item do projeto 
no Gerenciador de Soluções. No menu de contexto que será 
mostrado, selecione Editar arquivo de projeto. 

2. O arquivo de projeto .csproj será aberto. Adicione um 
elemento  Nullable ao elemento | PropertyGroup 
conforme mostrado a seguir: 


<PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debu 
g|AnyCPU' "> 


<Nullable>enable</Nullable> 


</PropertyGroup> 

1 EFi<Project Sdk="Microsoft.NET.Sdk"> 

2 

3 E <PropertyGroup> 

4 <OutputType>Exe</OutputType> 

9 <TargetFramework>netcoreapp3.0</TargetFramework> 

6 </PropertyGroup> 

7 

8 E <PropertyGroup Condition="'$(Configuration) |$(Platform)'=='Debug|AnyCPU'"> 
9 <DocumentationFile>C: JUsersiClaudioisourcelreposiProdutividadeEmCSharpiPro 
10 <NoWarn>1701;1702;1591</NoWarn> 

11 <DefineConstants>TRACE; EdicaoProfissional</DefineConstants> 

al Fanolisblesenable</Nulioble>] 

13 <«fPropertycroupo 777777 

14 

15 E <ItemGroup> 

16 <PackageReference Include="System.ValueTuple" Version="4.5.0" /> 

17 </ItemGroup> 

18 


19 |</Project> 


Figura 14.11: Adicionando suporte a tipos de referência anuláveis 
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Caso deseje ativar o recurso em um único arquivo, utilize a 
diretiva &nullable com o valor enable no arquivo deste modo: 


#nullable enable 
string titulo = null; //Isto gera um aviso 


Com o suporte a tipos de referência anuláveis ativado, 
qualquer atribuição de valor nulo a tipos de referência não 
anuláveis provocará um alerta de compilação com a mensagem: 
Conversão de literal nula ou possível valor nulo em 
tipo não anulável. 


O Visual Studio oferece correção para o problema por meio de 
uma ação rápida. Veja: 


= namespace ProdutividadeEmCSharp 


{ 


= class Program 


{ 
= static void Main(string[] ) 
{ 
#nullable enable 
string titulo = null; //Isto gera um aviso 


} 9- 








Declarar como anulável d 





Å CS2600 Conversão de literal nula ou possível valor nulo em tipo não 
anulável, 





Configurar ou Suprimir problemas + 


&null ble 
string titulo = null; //Isto gera um aviso 


stringi titulo = null; //Isto gera um aviso 
F 





Visualizar alterações 


Corrigir todas as ocorrências em: Documento | Projeto | Solução 


Figura 14.12: Convertendo a declaração para um tipo de referência anulável 


As regras passam a ser as seguintes: 


e Os tipos de referência não anuláveis não precisam ser 
verificados como nulos antes que eles sejam 
desreferenciados. 
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e Uma verificação nula é necessária para remover o aviso em 
locais que a ação de desreferenciar uma referência anulável 
possa gerar uma exceção. 


Veja a seguir um exemplo: 


namespace ProdutividadeEmCSharp 


{ 
class Program 
{ 
static void Main(string[] args) 
{ 
#nullable enable 
string? titulo = null; 
int tamanho1 = titulo.Length; //Isto gera aviso 
if (titulo != null) 
{ 
int tamanho2 = titulo.Length; //Isto não gera avi 
so 
3 
3 
3 
3 


Saiba que este comportamento pode ser modificado usando o 
operador null-tolerante (!) (em inglês, null-forgiving operator) 
incluído no C# 8.0. Ele é útil para suprimir o aviso nos casos em 
que temos certeza de que a variável anulável não está definida 
como nula. Exemplo: 


int tamanho? = titulo!.Length; 


456 14.6 ATIVANDO O SUPORTE A TIPOS DE REFERÊNCIA ANULÁVEIS 


Para saber mais sobre o operador null-forgiving, consulte a 
seguinte página da documentação oficial: 


https://docs.microsoft.com/pt-br/dotnet/csharp/language- 
reference/operators/null-forgiving 





14.7 AGRUPANDO OS MEMBROS DAS 
CLASSES EM REGIÕES 


As diretivas de pré-processador #region e #endregion são 
usadas para criar regiões no código-fonte. 


Uma região é uma forma elegante e simples de agrupar os 
membros de uma classe, enquanto fornece um nome significativo 
para ela. Desse modo, é possível com um clique de mouse ocultar 
ou expandir o código contido na região. Para declarar uma região 
usamos a sintaxe a seguir: 


region Nome da região 
Hendregion 
Vejamos um exemplo: 
public class Livro 
{ 
#region Propriedades 
public string Nome { get; set; } 
public int Id { get; } 


public string Log { private get; set; } 
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public string Titulo ( get; set; ) = "Produtividade em C&"; 
public string Autor { get; set; } = "Cláudio Ralha"; 


public DateTime DataCadastramento ( get; private set; ) = Dat 
eTime.Now; 


public decimal Preco ( get; private set; ) = 50; 
gendregion 

gregion Métodos 

//TODO: Implementar métodos da classe 


gendregion 


O poder desse recurso está na capacidade de ocultar ou exibir o 
código interno da região, o que pode ser feito clicando no controle 
existente à esquerda da declaração da região. 


O agrupamento do código em regiões se torna ainda mais 
valoroso para a organização do código quando descobrimos que é 
possível declarar regiões aninhadas, ou seja, uma região dentro de 
outras ou uma região dentro de um método longo. Também é 
possível selecionar todo o código de uma região colapsada com um 
clique do mouse sobre o número de linha inicial da região e 
arrastar o código para uma nova posição dentro do arquivo. 


A organização do código de uma classe em regiões pode ser 
baseada na natureza dos membros, como propriedades, 
construtores e métodos; ou recorrendo a alguma outra forma de 
organização que você julgue mais adequada para as classes dos seus 
projetos (métodos de CRUD, métodos de importação e exportação 
de dados etc.). 
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Conforme você pôde observar ao longo deste capítulo, a 
linguagem C# oferece recursos interessantes de compilação 
condicional por meio de suas diretivas de pré-processador. Isso é 
algo bastante explorado por pessoas com background em 
linguagens, como C, C++ e Object Pascal, mas é pouco explorado 
por quem desenvolve em C#. 


Obviamente, a compilação condicional não será capaz de 
resolver todos os nossos problemas. Para os casos em que for 
necessário ativar ou desativar uma funcionalidade em tempo de 
execução, bastará recorrer a uma abordagem baseada em variáveis 
sinalizadoras. 
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